Zeichenfolgenformatfunktionen

Windows GDI+ macht eine flache API verfügbar, die aus etwa 600 Funktionen besteht, die in Gdiplus.dll implementiert und in Gdiplusflat.h deklariert werden. Die Funktionen in der GDI+ flachen API werden von einer Sammlung von etwa 40 C++-Klassen umschlossen. Es wird empfohlen, die Funktionen in der flachen API nicht direkt aufzurufen. Wenn Sie aufruft, GDI+, sollten Sie dazu die Methoden und Funktionen aufrufen, die von den C++-Wrappern bereitgestellt werden. Microsoft Product Support Services bietet keine Unterstützung für Code, der die flache API direkt aufruft. Weitere Informationen zur Verwendung dieser Wrappermethoden finden Sie unter GDI+ Flat-API.

Die folgenden flachen API-Funktionen werden von der StringFormat C++-Klasse umschlossen.

StringFormat-Funktionen und entsprechende Wrappermethoden

Flat-Funktion Wrappermethode Bemerkungen
GpStatus WINGDIPAPI GdipCreateStringFormat( INT formatAttributes, LANGID language, GpStringFormat * * format )
StringFormat::StringFormat( IN INT formatFlags = 0, IN LANGID language = LANG _ NEUTRAL )
Erstellt ein StringFormat-Objekt basierend auf Zeichenfolgenformatflags und einer Sprache.
GpStatus WINGDIPAPI GdipStringFormatGetGenericDefault(GpStringFormat-Format) * *
StringFormat * StringFormat::GenericDefault()
Erstellt ein generisches, standardmäßiges StringFormat-Objekt.
GpStatus WINGDIPAPI GdipStringFormatGetGenericTypographic(GpStringFormat * * format)
StringFormat * StringFormat::GenericTypographic()
Erstellt ein generisches typografisches StringFormat-Objekt.
GpStatus WINGDIPAPI GdipDeleteStringFormat(GpStringFormat-Format) *
StringFormat::~StringFormat()
Gibt die vom StringFormat-Objekt verwendeten Ressourcen frei.
GpStatus WINGDIPAPI GdipCloneStringFormat(GDIPCONST GpStringFormat * format, GpStringFormat * * newFormat)
StringFormat::StringFormat( IN const StringFormat * format )
Erstellt ein StringFormat-Objekt aus einem anderen StringFormat-Objekt.
GpStatus WINGDIPAPI GdipSetStringFormatFlags(GpStringFormat-Format, * INT-Flags)
Status StringFormat::SetFormatFlags(IN INT-Flags)
Legt die Formatflags für dieses StringFormat-Objekt fest. Die Formatflags bestimmen die meisten Merkmale eines StringFormat-Objekts.
GpStatus WINGDIPAPI GdipGetStringFormatFlags(GDIPCONST * GpStringFormat-Format, * INT-Flags)
INT StringFormat::GetFormatFlags() const
Ruft die Zeichenfolgenformatflags für dieses StringFormat-Objekt ab.
GpStatus WINGDIPAPI GdipSetStringFormatAlign(GpStringFormat * format, StringAlignment align)
Status StringFormat::SetAlignment(IN StringAlignment align)
Legt die Linienausrichtung dieses StringFormat-Objekts in Bezug auf den Ursprung des Layoutrechtecks fest. Die Einstellung für die Linienausrichtung gibt an, wie die Zeichenfolge vertikal im Layoutrechteck ausgerichtet werden soll. Das Layoutrechteck wird verwendet, um die angezeigte Zeichenfolge zu positionieren.
GpStatus WINGDIPAPI GdipGetStringFormatAlign(GDIPCONST GpStringFormat * format, StringAlignment * align)
StringAlignment StringFormat::GetAlignment() const
Ruft ein Element der StringAlignment-Enumeration ab, das die Zeichenausrichtung dieses StringFormat-Objekts in Bezug auf den Ursprung des Layoutrechtecks angibt. Ein Layoutrechteck wird verwendet, um die angezeigte Zeichenfolge zu positionieren.
GpStatus WINGDIPAPI GdipSetStringFormatLineAlign(GpStringFormat * format, StringAlignment align)
Status StringFormat::SetLineAlignment(IN StringAlignment align)
Legt die Linienausrichtung dieses StringFormat-Objekts in Bezug auf den Ursprung des Layoutrechtecks fest. Die Einstellung für die Linienausrichtung gibt an, wie die Zeichenfolge vertikal im Layoutrechteck ausgerichtet werden soll. Das Layoutrechteck wird verwendet, um die angezeigte Zeichenfolge zu positionieren.
GpStatus WINGDIPAPI GdipGetStringFormatLineAlign(GDIPCONST GpStringFormat * format, StringAlignment * align)
StringAlignment StringFormat::GetLineAlignment() const
Ruft ein Element der StringAlignment-Enumeration ab, das die Linienausrichtung dieses StringFormat-Objekts in Bezug auf den Ursprung des Layoutrechtecks angibt. Die Einstellung für die Linienausrichtung gibt an, wie die Zeichenfolge vertikal im Layoutrechteck ausgerichtet werden soll. Das Layoutrechteck wird verwendet, um die angezeigte Zeichenfolge zu positionieren.
GpStatus WINGDIPAPI GdipSetStringFormatTrimming( GpStringFormat * format, StringTrimming trimming )
Status StringFormat::SetTrimming(IN StringTrimming trimming)
Legt den Kürzungsstil für dieses StringFormat-Objekt fest. Der Kürzungsstil bestimmt, wie eine Zeichenfolge so gekürzt wird, dass sie in das Layoutrechteck passt.
GpStatus WINGDIPAPI GdipGetStringFormatTrimming( GDIPCONST GpStringFormat * format, StringTrimming * trimming )
StringTrimming StringFormat::GetTrimming() const
Ruft ein Element der StringTrimming-Enumeration ab, das den Kürzungsstil dieses StringFormat-Objekts angibt. Der Kürzungsstil bestimmt, wie Zeichen aus einer Zeichenfolge entfernt werden, die zu groß ist, um in das Layoutrechteck zu passen.
GpStatus WINGDIPAPI GdipSetStringFormatHotkeyPrefix(GpStringFormat * format, INT hotkeyPrefix)
Status StringFormat::SetHotkeyPrefix(IN HotkeyPrefix hotkeyPrefix)
Legt den Verarbeitungstyp fest, der für eine Zeichenfolge ausgeführt wird, wenn das Hot-Key-Präfix , ein ampersand (&), gefunden wird. Das "ampersand" wird als Präfix für den heißen Schlüssel bezeichnet und kann verwendet werden, um bestimmte Schlüssel als "Hot Keys" festzulegen.
GpStatus WINGDIPAPI GdipGetStringFormatHotkeyPrefix(GDIPCONST GpStringFormat * format, INT * hotkeyPrefix)
HotkeyPrefix StringFormat::GetHotkeyPrefix() const
Ruft ein Element der HotkeyPrefix-Enumeration ab, das den Verarbeitungstyp angibt, der für eine Zeichenfolge ausgeführt wird, wenn ein Hot-Key-Präfix, ein "ampersand" (&), gefunden wird.
GpStatus WINGDIPAPI GdipSetStringFormatTabStops(GpStringFormat * format, REAL firstTabOffset, INT count, GDIPCONST REAL * tabStops)
Status StringFormat::SetTabStops( IN REAL firstTabOffset, IN INT count, IN const REAL * tabStops )
Legt die Offsets für Tabstopps in diesem StringFormat-Objekt fest.
GpStatus WINGDIPAPI GdipGetStringFormatTabStops(GDIPCONST GpStringFormat * format, INT count, REAL * firstTabOffset, REAL * tabStops)
Status StringFormat::GetTabStops( IN INT count, OUT REAL * firstTabOffset, OUT REAL * tabStops ) const
Ruft die Offsets der Tabstopps in diesem StringFormat-Objekt ab.
GpStatus WINGDIPAPI GdipGetStringFormatTabStopCount(GDIPCONST GpStringFormat * format, INT * count)
INT StringFormat::GetTabStopCount() const
Ruft die Anzahl der Tabstoppoffsets in diesem StringFormat-Objekt ab.
GpStatus WINGDIPAPI GdipSetStringFormatDigitSubsafter(GpStringFormat * format, LANGID language, StringDigitSubstitute substitute)
Status StringFormat::SetDigitSubsafter( IN LANGID language, IN StringDigitSubstitute substitute )
Legt die Ersetzungsmethode für Ziffern und die Sprache fest, die den Ziffernaustauschern entspricht.
GpStatus WINGDIPAPI GdipGetStringFormatDigitSubsafter(GDIPCONST GpStringFormat * format, LANGID * language, StringDigitSubstitute * substitute)
StringDigitSubstitute StringFormat::GetDigitSubsquartMethod( ) const
ruft ein Element der StringDigitSubstitute-Enumeration ab, das die von diesem StringFormat-Objekt verwendete Ziffernersetzungsmethode angibt.
Der Sprachparameter in der flat-Funktion ist ein 16-Bit-Wert, der die zu verwendende Sprache angibt.
GpStatus WINGDIPAPI GdipGetStringFormatMeasurableCharacterRangeCount( GDIPCONST GpStringFormat * format, INT * count )
INT StringFormat::GetMeasurableCharacterRangeCount()
ruft die Anzahl der messbaren Zeichenbereiche ab, die derzeit festgelegt sind. Die festgelegten Zeichenbereiche können mithilfe der Graphics::MeasureCharacterRanges-Methode in einer Zeichenfolge gemessen werden.
GpStatus WINGDIPAPI GdipSetStringFormatMeasurableCharacterRanges( GpStringFormat * format, INT rangeCount, GDIPCONST CharacterRange * ranges )
Status StringFormat::SetMeasurableCharacterRanges( IN INT rangeCount, IN const CharacterRange * ranges )
Legt eine Reihe von Zeichenbereichen für dieses StringFormat-Objekt fest, die in einer Zeichenfolge von der Graphics::MeasureCharacterRanges-Methode gemessen werden können.