SetTextAlign-Funktion (wingdi.h)

Artikel
08/27/2023

Die SetTextAlign-Funktion legt die Textausrichtungsflags für den angegebenen Gerätekontext fest.

Syntax

UINT SetTextAlign(
  [in] HDC  hdc,
  [in] UINT align
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] align

Die Textausrichtung mithilfe einer Maske der Werte in der folgenden Liste. Aus den Flags, die sich auf die horizontale und vertikale Ausrichtung auswirken, kann nur ein Flag ausgewählt werden. Darüber hinaus kann nur eines der beiden Flags ausgewählt werden, die die aktuelle Position ändern.

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_NOUPDATECP	Die aktuelle Position wird nach jedem Textausgabeaufruf nicht aktualisiert. Der Referenzpunkt wird an die Textausgabefunktion übergeben.
TA_RTLREADING	Middle East Language Edition von Windows: Der Text ist in der Leserichtung von rechts nach links angeordnet, im Gegensatz zur Standardreihenfolge von links nach rechts. Dies gilt nur, wenn die im Gerätekontext ausgewählte Schriftart entweder Hebräisch oder Arabisch ist.
TA_UPDATECP	Die aktuelle Position wird nach jedem Textausgabeaufruf aktualisiert. Die aktuelle Position wird als Bezugspunkt verwendet.

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

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

Die Standardwerte sind TA_LEFT, TA_TOP und TA_NOUPDATECP.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die vorherige Textausrichtungseinstellung.

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

Hinweise

Die Funktionen TextOut und ExtTextOut verwenden die Textausrichtungsflags, um eine Textzeichenfolge auf einem Display oder einem anderen Gerät zu positionieren. Die Flags geben die Beziehung zwischen einem Bezugspunkt und einem Rechteck an, das den Text begrenzt. Der Referenzpunkt ist entweder die aktuelle Position oder ein Punkt, der an eine Textausgabefunktion übergeben wird.

Das Rechteck, das den Text begrenzt, wird durch die Zeichenzellen in der Textzeichenfolge gebildet.

Die beste Möglichkeit, linksbündigen Text zu erhalten, ist die Verwendung einer


SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))

oder


SetTextAlign (hdc,TA_LEFT | <other flags>)

Sie können zu diesem Zweck auch SetTextAlign (hdc, TA_LEFT) verwenden, aber dadurch werden alle vertikalen oder rechts-nach-links-Einstellungen verloren.

Hinweis Sie sollten SetTextAlign nicht mit TA_UPDATECP verwenden, wenn Sie ScriptStringOut verwenden, da markierter Text nicht ordnungsgemäß gerendert wird. Wenn Sie dieses Flag verwenden müssen, können Sie es nach Bedarf aufheben und zurücksetzen, um das Problem zu vermeiden.

Beispiele

Ein Beispiel finden Sie unter Festlegen der Textausrichtung.

Anforderungen


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 (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll