TextFormatFlags-Enumeration
Aktualisiert: November 2007
Gibt die Anzeige- und Layoutinformationen für Textzeichenfolgen an.
Diese Enumeration verfügt über ein FlagsAttribute-Attribut, das die bitweise Kombination der Memberwerte zulässt.
Namespace: System.Windows.FormsAssembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Membername | Beschreibung | |
|---|---|---|
| Bottom | Richtet den Text im unteren Teil des umschließenden Rechtecks aus. Wird nur angewendet, wenn der Text eine einzelne Zeile ist. | |
| EndEllipsis | Entfernt das Ende von abgeschnittenen Zeilen und ersetzt diese durch ein Auslassungszeichen. | |
| ExpandTabs | 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 | 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. | |
| Default | Wendet die Standardformatierung an, die links ausgerichtet ist. | |
| HidePrefix | Gilt nur für Windows 2000 und Windows XP: | |
| HorizontalCenter | Zentriert den Text horizontal innerhalb des umschließenden Rechtecks. | |
| Internal | Berechnet mit der Systemschriftart die Textmetrik. | |
| Left | Richtet den Text an der linken Seite des Clippingbereichs aus. | |
| ModifyString | Wirkt sich nicht auf den gezeichneten Text aus. | |
| NoClipping | Ermöglicht das Anzeigen von überhängenden Symbolbereichen und Text außerhalb des Formatierungsrechtecks. | |
| NoPrefix | Deaktiviert die Verarbeitung von Präfixzeichen. Das mnemonische Präfixzeichen für das kaufmännische Und (&) wird i. d. R. als Direktive zum Unterstreichen des nachfolgenden Zeichens interpretiert. Das mnemonische Präfixzeichen für das doppelte kaufmännische Und (&&) wird als Direktive zum Drucken eines einfachen kaufmännischen Und-Zeichens interpretiert. Durch Angeben von NoPrefix wird diese Verarbeitung deaktiviert. Wenn zum Beispiel eine Eingabezeichenfolge von "A&bc&&d" mit NoPrefix angewendet wird, lautet die Ausgabe "A&bc&&d". | |
| NoFullWidthCharacterBreak | Gilt nur für Windows 98, Windows Me, Windows 2000 oder Windows XP: | |
| PathEllipsis | Die Mitte der verkürzten Zeilen wird entfernt und durch ein Auslassungszeichen ersetzt. | |
| PrefixOnly | Gilt nur für Windows 2000 oder Windows XP: | |
| Right | Richtet den Text an der rechten Seite des Clippingbereichs aus. | |
| RightToLeft | Zeigt den Text von rechts nach links an. | |
| SingleLine | Zeigt den Text in einer einzelnen Zeile an. | |
| TextBoxControl | Gibt an, dass der Text zum Anzeigen auf einem TextBox-Steuerelement formatiert werden muss. | |
| Top | Richtet den Text im oberen Teil des umschließenden Rechtecks aus. | |
| VerticalCenter | Zentriert den Text vertikal innerhalb des umschließenden Rechtecks. | |
| WordBreak | Führt zu einem Textumbruch am Ende eines Worts. | |
| WordEllipsis | Gibt an, dass die Zeile am nächststehenden Wort abgeschnitten wird und am Ende der abgeschnittenen Zeile wird ein Auslassungszeichen angefügt wird. | |
| PreserveGraphicsClipping | 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 | Behält die von einer Graphics angegebene Transformation bei. Gilt nur für Methoden, die einen IDeviceContext empfangen, der eine Instanz von Graphics ist. | |
| GlyphOverhangPadding | Fügt dem umschließenden Rechteck Leerraum hinzu, um überhängende Symbole aufzunehmen. | |
| NoPadding | Fügt dem umschließenden Rechteck keinen Leerraum hinzu. | |
| LeftAndRightPadding | Fügt an beiden Seiten des umschließenden Rechtecks Leerraum hinzu. |
Die TextFormatFlags-Enumeration wird vom TextRenderer beim Zeichnen und Messen von Text verwendet. Der TextRenderer unterstützt nicht das Hinzufügen von Tabstopps in gezeichnetem Text, obwohl Sie vorhandene Tabstopps mithilfe des ExpandTabs-Flags erweitern können.
Im folgenden Codebeispiel wird die Verwendung der TextFormatFlags-Enumeration veranschaulicht. Fügen Sie zum Ausführen dieses Beispiels folgenden Code in ein Windows Form ein. Rufen Sie RenderText6 im Paint-Ereignishandler des Formulars auf, und übergeben Sie dabei e als PaintEventArgs-Objekt.
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); }
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
