TextFormatFlags Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Anzeige- und Layoutinformationen für Textzeichenfolgen an.
Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.
public enum class TextFormatFlags[System.Flags]
public enum TextFormatFlags[<System.Flags>]
type TextFormatFlags = Public Enum TextFormatFlags- Vererbung
- Attribute
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| Default | 0 | Wendet die Standardformatierung an, die linksbündig ausgerichtet ist. |
| GlyphOverhangPadding | 0 | Fügt dem umgebenden Rechteck Abstand hinzu, um überhangende Glyphen aufzunehmen. Dies ist die Standardoption. |
| Left | 0 | Richtet den Text auf der linken Seite des Beschneidungsbereichs aus. Dies ist die Standardoption. |
| Top | 0 | Richtet den Text oben im umgebenden Rechteck aus. Dies ist die Standardoption. |
| HorizontalCenter | 1 | Zentriert den Text horizontal innerhalb des umgebenden Rechtecks. |
| Right | 2 | Richtet den Text auf der rechten Seite des Beschneidungsbereichs aus. |
| VerticalCenter | 4 | Zentriert den Text vertikal innerhalb des umgebenden Rechtecks. |
| Bottom | 8 | Richtet den Text am unteren Rand des umgebenden Rechtecks aus. Wird nur angewendet, wenn der Text eine einzelne Zeile ist. |
| WordBreak | 16 | Umbricht den Text am Ende eines Worts. |
| SingleLine | 32 | Zeigt den Text in einer einzelnen Zeile an. |
| ExpandTabs | 64 | Erweitert Tabstoppzeichen. Die Standardanzahl von Zeichen pro Registerkarte beträgt acht. Die WordEllipsisWerte PathEllipsisund Werte EndEllipsis können nicht mit ExpandTabs. |
| NoClipping | 256 | Ermöglicht das Anzeigen der überhangenden Teile von Glyphen und entwappten Text, der außerhalb des Formatierungsrechtecks liegt. |
| ExternalLeading | 512 | Enthält die Schriftart, die in der Zeilenhöhe von außen vorangestellter Zeichen ist. In der Regel ist die externe Vorleitung nicht in der Höhe einer Textzeile enthalten. |
| NoPrefix | 2048 | Deaktiviert die Verarbeitung von Präfixzeichen. In der Regel wird das mnemonische Präfixzeichen als Direktive interpretiert, um das folgende Zeichen zu unterstreichen, und die doppel-ampersandischen (&&&) Mnemonic-Präfixzeichen als Direktive zum Drucken eines einzelnen kaufmännischen Und-Zeichens. Durch Angabe NoPrefixwird diese Verarbeitung deaktiviert. Beispielsweise würde eine Eingabezeichenfolge von "A&bc&&d" mit NoPrefix angewendetem Ergebnis die Ausgabe von "A&bc&&d" ergeben. Vergleichen mit |
| Internal | 4096 | Verwendet die Systemschriftart zum Berechnen von Textmetriken. |
| TextBoxControl | 8192 | Gibt an, dass der Text für die Anzeige in einem TextBox Steuerelement formatiert werden soll. |
| PathEllipsis | 16384 | Entfernt die Mitte der gekürzten Linien und ersetzt sie durch eine Auslassungspunkte. Wenn sie zum Zeichnen von Text verwendet |
| EndEllipsis | 32768 | Entfernt das Ende der gekürzten Linien und ersetzt sie durch eine Auslassungspunkte. Wenn sie zum Zeichnen von Text verwendet |
| ModifyString | 65536 | Hat keine Auswirkung auf den gezeichneten Text oder die Textmaße. Wenn sie zum Zeichnen von Text verwendet |
| RightToLeft | 131072 | Zeigt den Text von rechts nach links an. |
| WordEllipsis | 262144 | Schneidet die Linie auf das nächste Wort, und am Ende einer gekürzten Linie wird ein Auslassungszeichen platziert. Vergleichen mit EndEllipsis und PathEllipsis. |
| NoFullWidthCharacterBreak | 524288 | Ein Legacywert, der keine Auswirkung hat. Sie verhindert einen Zeilenumbruch bei einer doppelt breiten Zeichenfolge, sodass die Zeilenumbruchregel für einzelne Zeichenfolgen gleichbedeutend ist. |
| HidePrefix | 1048576 | Ignoriert das Präfixzeichen (&) im Text, sodass der folgende Buchstabe nicht unterstrichen wird, andere Mnemonic-Präfixzeichen jedoch weiterhin verarbeitet werden. |
| PrefixOnly | 2097152 | Zeichnet nur eine Unterstreichung an der Position des Zeichens nach dem Präfixzeichen (&) und zeichnet keine anderen Zeichen in der Zeichenfolge. |
| PreserveGraphicsClipping | 16777216 | Behält den von einem Graphics Objekt angegebenen Clipping bei. Gilt nur für Methoden, die ein IDeviceContextGraphics |
| PreserveGraphicsTranslateTransform | 33554432 | Behält die durch eine Graphics. Gilt nur für Methoden, die ein IDeviceContextGraphics |
| NoPadding | 268435456 | Fügt dem umgebenden Rechteck keinen Abstand hinzu. |
| LeftAndRightPadding | 536870912 | Fügt auf beiden Seiten des umgebenden Rechtecks Abstand hinzu. |
Beispiele
Im folgenden Beispiel wird die Verwendung der TextFormatFlags Enumeration veranschaulicht. Zum Ausführen dieses Beispiels fügen Sie den folgenden Code in ein Windows Formular ein. Aufrufen RenderText6 aus dem Ereignishandler des Formulars Paint , übergeben als ePaintEventArgs.
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
Hinweise
Die TextFormatFlags Aufzählung wird beim Zeichnen und Messen von TextRenderer Text verwendet. Das TextRenderer Hinzufügen von Tabstopps zum gezeichneten Text wird nicht unterstützt, sie können jedoch vorhandene Tabstopps mithilfe der ExpandTabs Kennzeichnung erweitern.
