TextFormatFlags Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica le informazioni relative alla visualizzazione e al layout per le stringhe di testo.
Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.
public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
[<System.Flags>]
type TextFormatFlags =
Public Enum TextFormatFlags
- Ereditarietà
- Attributi
Campi
Bottom | 8 | Allinea il testo in basso al rettangolo di delimitazione. Applicato solo se il testo è su singola riga. |
Default | 0 | Si applica alla formattazione predefinita, allineata a sinistra. |
EndEllipsis | 32768 | Rimuove la parte finale delle righe troncate e la sostituisce con i puntini di sospensione. Se utilizzato per disegnare testo da |
ExpandTabs | 64 | Espande i caratteri di tabulazione. Il numero predefinito di caratteri per tabulazione è otto. Non è possibile utilizzare i valori WordEllipsis, PathEllipsis e EndEllipsis con la classe ExpandTabs. |
ExternalLeading | 512 | Include l'interlinea esterna del tipo di carattere nell'altezza della riga. Solitamente, l'interlinea esterna non è inclusa nell'altezza di una riga di testo. |
GlyphOverhangPadding | 0 | Aggiunge spaziatura al rettangolo di delimitazione per sistemare le parti sporgenti delle icone. Questa è la modalità predefinita. |
HidePrefix | 1048576 | Ignora il carattere prefisso e commerciale (&) nel testo, in modo che la lettera che segue non venga sottolineata, ma altri caratteri con prefisso mnemonico vengono ancora elaborati. |
HorizontalCenter | 1 | Centra il testo orizzontalmente all'interno del rettangolo di delimitazione. |
Internal | 4096 | Utilizza il tipo di carattere di sistema per calcolare le dimensioni del testo. |
Left | 0 | Allinea il testo al lato sinistro dell'area di visualizzazione. Questa è la modalità predefinita. |
LeftAndRightPadding | 536870912 | Aggiunge spaziatura a entrambi i lati del rettangolo di delimitazione. |
ModifyString | 65536 | Non ha alcun effetto sulle misurazioni di testo o testo disegnate. Quando viene usato per disegnare testo da |
NoClipping | 256 | Consente la visualizzazione delle parti sporgenti delle icone e del testo senza ritorno a capo che fuoriesce dal rettangolo di formattazione. |
NoFullWidthCharacterBreak | 524288 | Valore legacy senza alcun effetto. 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. |
NoPadding | 268435456 | Non aggiunge spaziatura al rettangolo di delimitazione. |
NoPrefix | 2048 | Disattiva l'elaborazione dei caratteri prefisso. In genere, la e commerciale (&) carattere prefisso mnemonico viene interpretata come direttiva per evidenziare il carattere che segue e l'e commerciale doppia (&&) caratteri di prefisso mnemonico come direttiva per stampare una singola e commerciale. Specificando l'enumerazione NoPrefix, questa elaborazione viene disattivata. Ad esempio, una stringa di input "A&bc&&d" con NoPrefix applicata genera l'output di "A&bc&&d". Confrontare con |
PathEllipsis | 16384 | Rimuove la parte centrale delle righe troncate e la sostituisce con i puntini di sospensione. Se utilizzato per disegnare testo da |
PrefixOnly | 2097152 | Disegna solo una sottolineatura nella posizione del carattere dopo il carattere e commerciale (&) prefisso e non disegna altri caratteri nella stringa. |
PreserveGraphicsClipping | 16777216 | Mantiene la visualizzazione specificata da un oggetto Graphics. Si applica solo ai metodi che ricevono un'interfaccia IDeviceContext che sia una classe Graphics. |
PreserveGraphicsTranslateTransform | 33554432 | Mantiene la trasformazione specificata da un oggetto Graphics. Si applica solo ai metodi che ricevono un'interfaccia IDeviceContext che sia una classe Graphics. |
Right | 2 | Allinea il testo al lato destro dell'area di visualizzazione. |
RightToLeft | 131072 | Visualizza il testo da destra a sinistra. |
SingleLine | 32 | Visualizza il testo su una singola riga. |
TextBoxControl | 8192 | Specifica che il testo deve essere formattato per la visualizzazione su un controllo TextBox. |
Top | 0 | Allinea il testo in alto al rettangolo di delimitazione. Questa è la modalità predefinita. |
VerticalCenter | 4 | Centra il testo verticalmente all'interno del rettangolo di delimitazione. |
WordBreak | 16 | Interrompe il testo alla fine di una parola. |
WordEllipsis | 262144 | Taglia la riga all'altezza della parola più vicina e posiziona i puntini di sospensione alla fine della linea troncata. Confrontare EndEllipsis e PathEllipsis. |
Esempio
Nell'esempio seguente viene illustrato come usare l'enumerazione TextFormatFlags
. Per eseguire questo esempio, incollare il codice seguente in un Windows Form. Chiamare RenderText6
dal gestore eventi del Paint modulo, passando e
come 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'enumerazione TextFormatFlags
viene utilizzata da durante il disegno e la TextRenderer misurazione del testo. L'oggetto TextRenderer non supporta l'aggiunta di tabulazioni al testo disegnato, anche se è possibile espandere le tabulazioni esistenti usando il ExpandTabs
flag .