Zeichenfolgenformatfunktionen

Windows GDI+ macht eine flache API verfügbar, die aus ca. 600 Funktionen besteht, die in Gdiplus.dll implementiert und in Gdiplusflat.h deklariert sind. Die Funktionen in der GDI+-Flach-API werden durch eine Auflistung von ca. 40 C++-Klassen umschlossen. Es wird empfohlen, die Funktionen in der flachen API nicht direkt aufzurufen. Wenn Sie Aufrufe an GDI+ tätigen, sollten Sie dies tun, indem Sie die Methoden und Funktionen aufrufen, die von den C++-Wrappern bereitgestellt werden. Microsoft-Produktsupportdienste bieten 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

Flache Funktion	Wrapper-Methode	Bemerkungen
GpStatus WINGDIPAPI GdipCreateStringFormat( INT formatAttributes, LANGID language, GpStringFormat **format )	StringFormat::StringFormat( INT formatFlags = 0, IN LANGID language = LANG_NEUTRAL )	Erstellt ein StringFormat- -Objekt basierend auf Zeichenfolgenformatkennzeichnungen 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 Ressourcen frei, die vom StringFormat--Objekt verwendet werden.
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(INT flags)	Legt die Formatkennzeichnungen für dieses StringFormat--Objekt fest. Die Formatkennzeichnungen bestimmen die meisten Merkmale eines StringFormat--Objekts.
GpStatus WINGDIPAPI GdipGetStringFormatFlags(GDIPCONST GpStringFormat *format, INT *flags)	INT StringFormat::GetFormatFlags() const	Ruft die Zeichenfolgenformatkennzeichnungen 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 im Verhältnis zum 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 im Verhältnis zum 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 im Verhältnis zum 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, die die Linienausrichtung dieses StringFormat- -Objekts im Verhältnis zum 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. Die Formatvorlage zum Kürzen 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--Aufzählung ab, die den Kürzungsstil dieses StringFormat- -Objekts angibt. Die Formatvorlage zum Kürzen bestimmt, wie Zeichen aus einer Zeichenfolge gekürzt 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 Typ der Verarbeitung fest, die für eine Zeichenfolge ausgeführt wird, wenn das Präfix für die Hot key, ein kaufmännisches Und-Zeichen (&) gefunden wird. Das kaufmännische Und-Zeichen wird als Abkürzungspräfix 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, die den Typ der Verarbeitung angibt, die für eine Zeichenfolge ausgeführt wird, wenn ein Präfix mit hot key, ein kaufmännisches Und-Zeichen (&) 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( 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 Tabstopp-Offsets in diesem StringFormat -Objekt ab.
GpStatus WINGDIPAPI GdipSetStringFormatDigitSubstitution(GpStringFormat *format, LANGID language, StringDigitSubstitute substitute)	Status StringFormat::SetDigitSubstitution( IN LANGID language, IN StringDigitSubstitute substitute )	Legt die Ziffernersetzungsmethode und die Sprache fest, die den Ziffernaustauschern entspricht.
GpStatus WINGDIPAPI GdipGetStringFormatDigitSubstitution(GDIPCONST GpStringFormat *format, LANGID *language, StringDigitSubstitute *substitute)	StringDigitSubstitute StringFormat::GetDigitSubstitutionMethod( ) const	ruft ein Element der StringDigitSubstitute--Aufzählung ab, die die von diesem StringFormat -Objekt verwendete Ziffernersetzungsmethode angibt. Die Sprache Parameter in der flachen 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 in einer Zeichenfolge mithilfe der Graphics::MeasureCharacterRanges-Methode gemessen werden.
GpStatus WINGDIPAPI GdipSetStringFormatMeasurableCharacterRanges( GpStringFormat *format, INT rangeCount, GDIPCONST CharacterRange *ranges )	Status StringFormat::SetMeasurableCharacterRanges( INT rangeCount, IN const CharacterRange *ranges )	Legt eine Reihe von Zeichenbereichen für dieses StringFormat -Objekt fest, die in einer Zeichenfolge durch die Graphics::MeasureCharacterRanges -Methode gemessen werden kann.