GetTextAlign-Funktion (wingdi.h)

Artikel
03/04/2024

Die GetTextAlign-Funktion ruft die Textausrichtungseinstellung für den angegebenen Gerätekontext ab.

Syntax

UINT GetTextAlign(
  [in] HDC hdc
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der status der Textausrichtungsflags. Weitere Informationen zum Rückgabewert finden Sie im Abschnitt Hinweise. Der Rückgabewert ist eine Kombination der folgenden Werte.

Wert	Bedeutung
TA_BASELINE	Der Referenzpunkt befindet sich in der Basiszeile des Texts.
TA_BOTTOM	Der Bezugspunkt befindet sich am unteren Rand des umgebenden Rechtecks.
TA_TOP	Der Bezugspunkt befindet sich am oberen Rand des umgebenden Rechtecks.
TA_CENTER	Der Bezugspunkt wird horizontal an der Mitte des umgebenden Rechtecks ausgerichtet.
TA_LEFT	Der Bezugspunkt befindet sich am linken Rand des umgebenden Rechtecks.
TA_RIGHT	Der Bezugspunkt befindet sich am rechten Rand des umgebenden Rechtecks.
TA_RTLREADING	Sprachausgabe "Naher Osten" von Windows: Der Text ist in der Lesereihenfolge von rechts nach links angeordnet, im Gegensatz zur standardmäßigen Reihenfolge von links nach rechts. Dies gilt nur, wenn die im Gerätekontext ausgewählte Schriftart entweder hebräisch oder arabisch ist.
TA_NOUPDATECP	Die aktuelle Position wird nach jedem Textausgabeaufruf nicht aktualisiert.
TA_UPDATECP	Die aktuelle Position wird nach jedem Textausgabeaufruf aktualisiert.

Wenn die aktuelle Schriftart eine vertikale Standardbasislinie aufweist (wie bei Kanji), werden die folgenden Werte anstelle von TA_BASELINE und TA_CENTER verwendet.

Wert	Bedeutung
VTA_BASELINE	Der Referenzpunkt befindet sich in der Basiszeile des Texts.
VTA_CENTER	Der Bezugspunkt wird vertikal mit der Mitte des umgebenden Rechtecks ausgerichtet.

Wenn die Funktion fehlschlägt, wird der Rückgabewert GDI_ERROR.

Hinweise

Das umgebende Rechteck ist ein Rechteck, das alle Zeichenzellen in einer Textzeichenfolge umgrenzt. Die Dimensionen können durch Aufrufen der GetTextExtentPoint32-Funktion abgerufen werden.

Die Textausrichtungsflags bestimmen, wie die Funktionen TextOut und ExtTextOut eine Textzeichenfolge in Bezug auf den Referenzpunkt der Zeichenfolge ausrichten, der für TextOut oder ExtTextOut bereitgestellt wird.

Die Textausrichtungsflags sind nicht unbedingt Einzelbitflags und können gleich 0 sein. Die Flags müssen in Gruppen verwandter Flags untersucht werden, wie in der folgenden Liste dargestellt.

TA_LEFT, TA_RIGHT und TA_CENTER
TA_BOTTOM, TA_TOP und TA_BASELINE
TA_NOUPDATECP und TA_UPDATECP

Wenn die aktuelle Schriftart eine vertikale Standardbasiszeile aufweist, sind die zugehörigen Flags wie in der folgenden Liste dargestellt.

TA_LEFT, TA_RIGHT und VTA_BASELINE
TA_BOTTOM, TA_TOP und VTA_CENTER
TA_NOUPDATECP und TA_UPDATECP

So überprüfen Sie, ob ein bestimmtes Flag im Rückgabewert dieser Funktion festgelegt ist:

Wenden Sie den bitweisen OR-Operator auf das Flag und die zugehörigen Flags an.
Wenden Sie den bitweisen AND-Operator auf das Ergebnis und den Rückgabewert an.
Testen Sie die Gleichheit dieses Ergebnisses und des Flags.

Beispiele

Ein Beispiel finden Sie unter Festlegen der Textausrichtung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll