GetTextAlign-Funktion (wingdi.h)

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:

  1. Wenden Sie den bitweisen OR-Operator auf das Flag und die zugehörigen Flags an.
  2. Wenden Sie den bitweisen AND-Operator auf das Ergebnis und den Rückgabewert an.
  3. 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

Weitere Informationen

ExtTextOut

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

GetTextExtentPoint32

SetTextAlign

Textout