TextFormatFlags Enumerazione

Definizione

Specifica le informazioni relative alla visualizzazione e al layout per le stringhe di testo.Specifies the display and layout information for text strings.

Questa enumerazione ha un attributo FlagsAttribute che consente una combinazione bit per bit dei valori del relativo membro.

public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
[<System.Flags>]
type TextFormatFlags = 
Public Enum TextFormatFlags
Ereditarietà
TextFormatFlags
Attributi

Campi

Bottom 8

Allinea il testo in basso al rettangolo di delimitazione.Aligns the text on the bottom of the bounding rectangle. Applicato solo se il testo è su singola riga.Applied only when the text is a single line.

Default 0

Si applica alla formattazione predefinita, allineata a sinistra.Applies the default formatting, which is left-aligned.

EndEllipsis 32768

Rimuove la parte finale delle righe troncate e la sostituisce con i puntini di sospensione.Removes the end of trimmed lines, and replaces them with an ellipsis. Quando viene usata per disegnare il testo tramite TextRenderer, la stringa non viene modificata a meno che non sia specificato il flag ModifyString.When used to draw text by TextRenderer, the string is not modified unless the ModifyString flag is specified. Confrontare PathEllipsis e WordEllipsis.Compare with PathEllipsis and WordEllipsis.

ExpandTabs 64

Espande i caratteri di tabulazione.Expands tab characters. Il numero predefinito di caratteri per tabulazione è otto.The default number of characters per tab is eight. Non è possibile utilizzare i valori WordEllipsis, PathEllipsis e EndEllipsis con la classe ExpandTabs.The WordEllipsis, PathEllipsis, and EndEllipsis values cannot be used with ExpandTabs.

ExternalLeading 512

Include l'interlinea esterna del tipo di carattere nell'altezza della riga.Includes the font external leading in line height. Solitamente, l'interlinea esterna non è inclusa nell'altezza di una riga di testo.Typically, external leading is not included in the height of a line of text.

GlyphOverhangPadding 0

Aggiunge spaziatura al rettangolo di delimitazione per sistemare le parti sporgenti delle icone.Adds padding to the bounding rectangle to accommodate overhanging glyphs. Questa è la modalità predefinita.This is the default.

HidePrefix 1048576

Il carattere di prefisso e commerciale (&) nel testo viene ignorato, in modo che la lettera che segue non venga sottolineata, ma altri caratteri di prefisso relativi al tasto di scelta vengano comunque elaborati.Ignores the ampersand (&) prefix character in the text, so that the letter that follows won't be underlined, but other mnemonic-prefix characters are still processed.

HorizontalCenter 1

Centra il testo orizzontalmente all'interno del rettangolo di delimitazione.Centers the text horizontally within the bounding rectangle.

Internal 4096

Utilizza il tipo di carattere di sistema per calcolare le dimensioni del testo.Uses the system font to calculate text metrics.

Left 0

Allinea il testo al lato sinistro dell'area di visualizzazione.Aligns the text on the left side of the clipping area. Questa è la modalità predefinita.This is the default.

LeftAndRightPadding 536870912

Aggiunge spaziatura a entrambi i lati del rettangolo di delimitazione.Adds padding to both sides of the bounding rectangle.

ModifyString 65536

Non ha alcun effetto sul testo disegnato o sulle misurazioni del testo.Has no effect on the drawn text or text measurements. Quando viene usato per disegnare il testo tramite TextRenderer, modifica il parametro stringa specificato in modo che corrisponda al testo visualizzato se vengono visualizzati i puntini di sospensione.When used to draw text by TextRenderer, modifies the specified string parameter to match the displayed text if ellipsis are shown. Questo valore non ha alcun effetto a meno che non si specifichi EndEllipsis o PathEllipsis.This value has no effect unless EndEllipsis or PathEllipsis is specified.

NoClipping 256

Consente la visualizzazione delle parti sporgenti delle icone e del testo senza ritorno a capo che fuoriesce dal rettangolo di formattazione.Allows the overhanging parts of glyphs and unwrapped text reaching outside the formatting rectangle to show.

NoFullWidthCharacterBreak 524288

Valore legacy senza alcun effetto.A legacy value that has no effect. Evita un'interruzione di riga in una stringa di caratteri a larghezza doppia, in modo che la regola dell'interruzione di riga sia equivalente a quella per le stringhe di caratteri a larghezza singola.It prevents a line break at a double-wide character string, so that the line-breaking rule is equivalent to that for single-wide character strings.

NoPadding 268435456

Non aggiunge spaziatura al rettangolo di delimitazione.Does not add padding to the bounding rectangle.

NoPrefix 2048

Disattiva l'elaborazione dei caratteri prefisso.Turns off processing of prefix characters. Il carattere di prefisso del tasto di scelta e commerciale (&) viene in genere interpretato come direttiva per sottolineare il carattere che segue e i caratteri di prefisso del tasto di scelta doppia e commerciale (&&) come direttiva per visualizzare una singola e commerciale.Typically, the ampersand (&) mnemonic-prefix character is interpreted as a directive to underscore the character that follows, and the double-ampersand (&&) mnemonic-prefix characters as a directive to print a single ampersand. Specificando l'enumerazione NoPrefix, questa elaborazione viene disattivata.By specifying NoPrefix, this processing is turned off. Ad esempio, una stringa di input "A&bc&&d" con NoPrefix applicato restituirà l'output "A&bc&&d".For example, an input string of "A&bc&&d" with NoPrefix applied would result in output of "A&bc&&d". Confrontare con PrefixOnly.Compare with PrefixOnly.

PathEllipsis 16384

Rimuove la parte centrale delle righe troncate e la sostituisce con i puntini di sospensione.Removes the center of trimmed lines and replaces it with an ellipsis. Quando viene usata per disegnare il testo tramite TextRenderer, la stringa non viene modificata a meno che non sia specificato il flag ModifyString.When used to draw text by TextRenderer, the string is not modified unless the ModifyString flag is specified. Confrontare EndEllipsis e WordEllipsis.Compare with EndEllipsis and WordEllipsis.

PrefixOnly 2097152

Disegna solo un carattere di sottolineatura in corrispondenza della posizione del carattere che segue il carattere con il prefisso e commerciale (&) e non disegna alcun altro carattere nella stringa.Draws only an underline at the position of the character following the ampersand (&) prefix character and doesn't draw any other characters in the string.

PreserveGraphicsClipping 16777216

Mantiene la visualizzazione specificata da un oggetto Graphics.Preserves the clipping specified by a Graphics object. Si applica solo ai metodi che ricevono un'interfaccia IDeviceContext che sia una classe Graphics.Applies only to methods receiving an IDeviceContext that is a Graphics.

PreserveGraphicsTranslateTransform 33554432

Mantiene la trasformazione specificata da un oggetto Graphics.Preserves the transformation specified by a Graphics. Si applica solo ai metodi che ricevono un'interfaccia IDeviceContext che sia una classe Graphics.Applies only to methods receiving an IDeviceContext that is a Graphics.

Right 2

Allinea il testo al lato destro dell'area di visualizzazione.Aligns the text on the right side of the clipping area.

RightToLeft 131072

Visualizza il testo da destra a sinistra.Displays the text from right to left.

SingleLine 32

Visualizza il testo su una singola riga.Displays the text in a single line.

TextBoxControl 8192

Specifica che il testo deve essere formattato per la visualizzazione su un controllo TextBox.Specifies the text should be formatted for display on a TextBox control.

Top 0

Allinea il testo in alto al rettangolo di delimitazione.Aligns the text on the top of the bounding rectangle. Questa è la modalità predefinita.This is the default.

VerticalCenter 4

Centra il testo verticalmente all'interno del rettangolo di delimitazione.Centers the text vertically, within the bounding rectangle.

WordBreak 16

Interrompe il testo alla fine di una parola.Breaks the text at the end of a word.

WordEllipsis 262144

Taglia la riga all'altezza della parola più vicina e posiziona i puntini di sospensione alla fine della linea troncata.Trims the line to the nearest word and an ellipsis is placed at the end of a trimmed line. Confrontare EndEllipsis e PathEllipsis.Compare with EndEllipsis and PathEllipsis.

Esempio

Nell'esempio seguente viene illustrato come utilizzare l' TextFormatFlags enumerazione.The following example demonstrates how to use the TextFormatFlags enumeration. Per eseguire questo esempio, incollare il codice seguente in un Windows Form.To run this example, paste the following code into a Windows Form. Chiamare RenderText6 dal Paint gestore eventi del form, passando e come PaintEventArgs .Call RenderText6 from the form's Paint event handler, passing e as PaintEventArgs.

private void RenderText6(PaintEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.EndEllipsis;
    TextRenderer.DrawText(e.Graphics, "This is some text that will be clipped at the end.", this.Font,
        new Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags);
}
Private Sub RenderText6(ByVal e As PaintEventArgs)
    Dim flags As TextFormatFlags = TextFormatFlags.Bottom Or _
        TextFormatFlags.EndEllipsis
    TextRenderer.DrawText(e.Graphics, _
    "This is some text that will be clipped at the end.", _
    Me.Font, New Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags)

End Sub

Commenti

L' TextFormatFlags enumerazione viene utilizzata da TextRenderer durante il disegno e la misurazione del testo.The TextFormatFlags enumeration is used by the TextRenderer when drawing and measuring text. Non TextRenderer supporta l'aggiunta di tabulazioni al testo disegnato, sebbene sia possibile espandere le tabulazioni esistenti utilizzando il ExpandTabs flag.The TextRenderer does not support adding tab stops to drawn text, although you can expand existing tab stops using the ExpandTabs flag.

Si applica a