TextFormatFlags Enumeration

Definition

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
TextFormatFlags
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 TextRendererverwendet wird, wird die Zeichenfolge nur geändert, wenn das ModifyString Flag angegeben ist. Verglichen mit PathEllipsis und WordEllipsis.

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 TextRendererverwendet wird, ändert der angegebene Zeichenfolgenparameter so, dass er dem angezeigten Text entspricht, wenn Auslassungspunkte angezeigt werden. Dieser Wert hat keine Auswirkung, es sei denn, EndEllipsis oder PathEllipsis wird angegeben.

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 PrefixOnly.

PathEllipsis 16384

Die Mitte der verkürzten Zeilen wird entfernt und durch ein Auslassungszeichen ersetzt. Wenn sie zum Zeichnen von TextRendererverwendet wird, wird die Zeichenfolge nur geändert, wenn das ModifyString Flag angegeben ist. Verglichen mit EndEllipsis und WordEllipsis.

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.

Gilt für:

Weitere Informationen