Freigeben über


SetTextAlign-Funktion (wingdi.h)

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

Weitere Informationen

ExtTextOut

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

GetTextAlign

ScriptStringOut

Textout