Freigeben über

StringFormatFlags-Aufzählung (gdiplusenums.h)

Die StringFormatFlags-Aufzählung gibt Textlayoutinformationen (z. B. Ausrichtung und Clipping) und Anzeigemanipulationen an (z. B. Einfügemarke, Ziffernersetzung und Darstellung von Zeichen, die von einer Schriftart nicht unterstützt werden).

Syntax

typedef enum StringFormatFlags {
  StringFormatFlagsDirectionRightToLeft = 0x00000001,
  StringFormatFlagsDirectionVertical = 0x00000002,
  StringFormatFlagsNoFitBlackBox = 0x00000004,
  StringFormatFlagsDisplayFormatControl = 0x00000020,
  StringFormatFlagsNoFontFallback = 0x00000400,
  StringFormatFlagsMeasureTrailingSpaces = 0x00000800,
  StringFormatFlagsNoWrap = 0x00001000,
  StringFormatFlagsLineLimit = 0x00002000,
  StringFormatFlagsNoClip = 0x00004000,
  StringFormatFlagsBypassGDI = 0x80000000
} ;

Konstanten

 
StringFormatFlagsDirectionRightToLeft
Wert: 0x00000001
Gibt an, dass die Leserichtung von rechts nach links erfolgt. Für horizontalen Text werden Zeichen von rechts nach links gelesen. Bei vertikalem Text werden Spalten von rechts nach links gelesen. Standardmäßig wird horizontaler oder vertikaler Text von links nach rechts gelesen.
StringFormatFlagsDirectionVertical
Wert: 0x00000002
Gibt an, dass einzelne Textzeilen vertikal auf dem Anzeigegerät gezeichnet werden. Standardmäßig sind Textzeilen horizontal, jede neue Zeile unterhalb der vorherigen Zeile.
StringFormatFlagsNoFitBlackBox
Wert: 0x00000004
Gibt an, dass Teile von Zeichen das Layoutrechteck der Zeichenfolge überhängen dürfen. Standardmäßig werden Zeichen zuerst innerhalb der Begrenzungen des Rechtecks ausgerichtet, dann werden alle Zeichen, die die Grenzen weiterhin überhängen, neu positioniert, um einen Überhang zu vermeiden und dadurch zu vermeiden, dass Pixel außerhalb des Layoutrechtecks beeinträchtigt werden. Ein kursiv geschriebener Buchstabe F (f) ist ein Beispiel für ein Zeichen, das überhangende Teile aufweisen kann. Durch Festlegen dieses Kennzeichens wird sichergestellt, dass das Zeichen visuell mit den Zeilen oben und unten ausgerichtet wird, aber möglicherweise Teile von Zeichen verursachen, die außerhalb des Layoutrechtecks liegen, abgeschnitten oder gezeichnet werden.
StringFormatFlagsDisplayFormatControl
Wert: 0x00000020
Gibt an, dass Unicode-Layoutsteuerelementzeichen mit einem repräsentativen Zeichen angezeigt werden.
StringFormatFlagsNoFontFallback
Wert: 0x00000400
Gibt an, dass eine alternative Schriftart für Zeichen verwendet wird, die in der angeforderten Schriftart nicht unterstützt werden. Standardmäßig werden fehlende Zeichen mit dem Zeichen "Schriftarten fehlen" angezeigt, in der Regel ein geöffnetes Quadrat.
StringFormatFlagsMeasureTrailingSpaces
Wert: 0x00000800
Gibt an, dass das Leerzeichen am Ende jeder Zeile in einem Zeichenfolgenmaß enthalten ist. Standardmäßig wird das begrenzungsrechteck, das von der
Graphics::MeasureString-Methode schließt das Leerzeichen am Ende jeder Zeile aus. Legen Sie dieses Kennzeichen fest, um diesen Abstand in die Maßeinheit einzuschließen.
StringFormatFlagsNoWrap
Wert: 0x00001000
Gibt an, dass der Textumbruch in die nächste Zeile deaktiviert ist. NoWrap wird impliziert, wenn anstelle eines Layoutrechtecks ein Ursprungspunkt verwendet wird. Wenn Text innerhalb eines Rechtecks gezeichnet wird, wird der Text standardmäßig an der letzten Wortgrenze unterbrochen, die sich innerhalb der Begrenzung des Rechtecks befindet und in die nächste Zeile eingeschlossen ist.
StringFormatFlagsLineLimit
Wert: 0x00002000
Gibt an, dass nur ganze Linien im Layoutrechteck angeordnet sind. Standardmäßig wird das Layout bis zum Ende des Texts fortgesetzt, oder bis keine weiteren Zeilen als Ergebnis des Ausschneidens sichtbar sind, je nachdem, was zuerst kommt. Mit den Standardeinstellungen kann die letzte Zeile teilweise durch ein Layoutrechteck verdeckt werden, das nicht ein ganzes Vielfaches der Zeilenhöhe ist. Um sicherzustellen, dass nur ganze Linien angezeigt werden, legen Sie dieses Kennzeichen fest, und achten Sie darauf, ein Layoutrechteck mindestens so hoch wie die Höhe einer Zeile bereitzustellen.
StringFormatFlagsNoClip
Wert: 0x00004000
Gibt an, dass Zeichen, die das Layoutrechteck überhängen, und Text, der sich außerhalb des Layoutrechtecks erstreckt, angezeigt werden dürfen. Standardmäßig werden alle überhängenden Zeichen und Text, die sich außerhalb des Layoutrechtecks erstrecken, abgeschnitten. Alle nachfolgenden Leerzeichen (Leerzeichen am Ende einer Zeile), die sich außerhalb des Layoutrechtecks erstrecken, werden abgeschnitten. Daher wirkt sich die Einstellung dieses Kennzeichens auf eine Zeichenfolgenmessung aus, wenn nachfolgende Leerzeichen in die Messung einbezogen werden. Wenn der Clipping aktiviert ist, sind nachfolgende Leerzeichen, die sich außerhalb des Layoutrechtecks erstrecken, nicht in der Maßeinheit enthalten. Wenn der Clipping deaktiviert ist, sind alle nachfolgenden Leerzeichen in der Maßeinheit enthalten, unabhängig davon, ob sie sich außerhalb des Layoutrechtecks befinden.
StringFormatFlagsBypassGDI
Wert: 0x80000000

Bemerkungen

Mehrere Kennzeichen können kombinierte Effekte erzeugen:

  • Wenn sowohl StringFormatFlagsDirectionVertical als auch StringFormatFlagsDirectionRightToLeft festgelegt werden, werden einzelne Textzeilen vertikal gezeichnet. Die erste Zeile beginnt am rechten Rand des Layoutrechtecks; Die zweite Textzeile befindet sich links neben der ersten Zeile usw.
  • Wenn StringFormatFlagsDirectionVertical festgelegt ist und StringFormatFlagsDirectionRightToLeft nicht festgelegt ist, werden einzelne Textzeilen vertikal gezeichnet. Die erste Zeile beginnt am linken Rand des Layoutrechtecks; Die zweite Textzeile befindet sich rechts neben der ersten Zeile.
  • Wenn StringFormatFlagsDirectionRightToLeft festgelegt ist und StringFormatFlagsDirectionVertical nicht festgelegt ist, sind die einzelnen Textzeilen horizontal und die Lesereihenfolge liegt von rechts nach links. Diese Einstellung ändert nicht die Reihenfolge, in der Zeichen angezeigt werden. Sie gibt einfach die Reihenfolge an, in der Zeichen gelesen werden können.
Die Flags StringFormatFlagsDirectionVertical und StringFormatFlagsDirectionRightToLeft können sich auf die Zeichenfolgenausrichtung auswirken.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows 2000 Server [nur Desktop-Apps]
Header gdiplusenums.h (include Gdiplus.h)

Siehe auch

DrawString-Methoden

Formatieren von Text

MeasureString-Methoden

StringAlignment

StringDigitSubstitute

StringFormat::SetFormatFlags

StringTrimming

  • Last updated on