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
Bottom | 8 | Richtet den Text im unteren Teil des umschließenden Rechtecks aus. Wird nur angewendet, wenn der Text eine einzelne Zeile ist. |
Default | 0 | Wendet die Standardformatierung an, die links ausgerichtet ist. |
EndEllipsis | 32768 | Entfernt das Ende von abgeschnittenen Zeilen und ersetzt diese durch ein Auslassungszeichen. Wenn sie zum Zeichnen von |
ExpandTabs | 64 | Erweitert Tabstoppzeichen. Die Standardanzahl von Zeichen pro Tabstopp beträgt acht. Die Werte WordEllipsis, PathEllipsis und EndEllipsis können nicht mit ExpandTabs verwendet werden. |
ExternalLeading | 512 | Schließt die externe Schriftartgröße in die Zeilenhöhe ein. I. d. R. wird der externe Abstand nicht in die Höhe einer Textzeile eingeschlossen. |
GlyphOverhangPadding | 0 | Fügt dem umschließenden Rechteck Leerraum hinzu, um überhängende Symbole aufzunehmen. Dies ist die Standardoption. |
HidePrefix | 1048576 | Ignoriert das Präfixzeichen ampersand (&) im Text, sodass der folgende Buchstabe nicht unterstrichen wird, aber andere mnemonische Präfixzeichen weiterhin verarbeitet werden. |
HorizontalCenter | 1 | Zentriert den Text horizontal innerhalb des umschließenden Rechtecks. |
Internal | 4096 | Berechnet mit der Systemschriftart die Textmetrik. |
Left | 0 | Richtet den Text an der linken Seite des Clippingbereichs aus. Dies ist die Standardoption. |
LeftAndRightPadding | 536870912 | Fügt an beiden Seiten des umschließenden Rechtecks Leerraum hinzu. |
ModifyString | 65536 | Hat kein Auswirkung auf den gezeichneten Text oder die Textabmessungen. Wenn sie zum Zeichnen von |
NoClipping | 256 | Ermöglicht das Anzeigen von überhängenden Symbolbereichen und Text außerhalb des Formatierungsrechtecks. |
NoFullWidthCharacterBreak | 524288 | Ein Legacywert, der keine Auswirkungen hat. Er verhindert einen Zeilenumbruch an einer Zeichenfolge von Zeichen doppelter Breite, sodass die Zeilenumbruchregel der für Zeichenfolgen von Zeichen einfacher Breite entspricht. |
NoPadding | 268435456 | Fügt dem umschließenden Rechteck keinen Leerraum hinzu. |
NoPrefix | 2048 | Deaktiviert die Verarbeitung von Präfixzeichen. In der Regel wird das mnemonische Präfixzeichen ampersand (&) als Direktive interpretiert, um das folgende Zeichen zu unterstreichen, und die mnemonischen Präfixzeichen mit doppeltem Ampersand (&&) als Anweisung zum Drucken eines einzelnen Ampersands. Durch Angeben von NoPrefix wird diese Verarbeitung deaktiviert. Beispielsweise würde eine Eingabezeichenfolge von "A&bc&&d" mit NoPrefix angewendet zur Ausgabe von "A&bc&&d" führen. Vergleichen Sie mit |
PathEllipsis | 16384 | Die Mitte der verkürzten Zeilen wird entfernt und durch ein Auslassungszeichen ersetzt. Wenn sie zum Zeichnen von |
PrefixOnly | 2097152 | Zeichnet nur eine Unterstreichung an der Position des Zeichens nach dem Präfixzeichen ampersand (&) und zeichnet keine anderen Zeichen in der Zeichenfolge. |
PreserveGraphicsClipping | 16777216 | Behält das von einem Graphics-Objekt angegebene Clipping bei. Gilt nur für Methoden, die einen IDeviceContext empfangen, der eine Instanz von Graphics ist. |
PreserveGraphicsTranslateTransform | 33554432 | Behält die von einer Graphics angegebene Transformation bei. Gilt nur für Methoden, die einen IDeviceContext empfangen, der eine Instanz von Graphics ist. |
Right | 2 | Richtet den Text an der rechten Seite des Clippingbereichs aus. |
RightToLeft | 131072 | Zeigt den Text von rechts nach links an. |
SingleLine | 32 | Zeigt den Text in einer einzelnen Zeile an. |
TextBoxControl | 8192 | Gibt an, dass der Text zum Anzeigen auf einem TextBox-Steuerelement formatiert werden muss. |
Top | 0 | Richtet den Text im oberen Teil des umschließenden Rechtecks aus. Dies ist die Standardoption. |
VerticalCenter | 4 | Zentriert den Text vertikal innerhalb des umschließenden Rechtecks. |
WordBreak | 16 | Führt zu einem Textumbruch am Ende eines Worts. |
WordEllipsis | 262144 | Gibt an, dass die Zeile am nächststehenden Wort abgeschnitten wird und am Ende der abgeschnittenen Zeile wird ein Auslassungszeichen angefügt wird. Verglichen mit EndEllipsis und PathEllipsis. |
Beispiele
Im folgenden Beispiel wird die Verwendung der TextFormatFlags
Enumeration veranschaulicht. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Windows Form-Format ein. Rufen Sie RenderText6
aus dem Ereignishandler des Formulars Paint auf, und übergeben Sie e
als 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
Hinweise
Die TextFormatFlags
Enumeration wird vom beim Zeichnen und Messen von TextRenderer Text verwendet.
TextRenderer unterstützt nicht das Hinzufügen von Tabstopps zum Zeichnen von Text, obwohl Sie vorhandene Tabstopps mithilfe des ExpandTabs
-Flags erweitern können.