IDWriteTextFormat::SetTextAlignment-Methode (dwrite.h)

Legt die Ausrichtung von Text in einem Absatz relativ zum vorangestellten und nachgestellten Rand eines Layoutfelds für eine IDWriteTextFormat-Schnittstelle fest.

Syntax

HRESULT SetTextAlignment(
  DWRITE_TEXT_ALIGNMENT textAlignment
);

Parameter

textAlignment

Typ: DWRITE_TEXT_ALIGNMENT

Die Textausrichtungsoption, die für den Absatz vom Typ DWRITE_TEXT_ALIGNMENT festgelegt wird. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Typ: HRESULT

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	Das argument textAlignment ist ungültig.

Hinweise

Der Text kann an der führenden oder nachgestellten Kante des Layoutfelds ausgerichtet oder zentriert werden. Die folgende Abbildung zeigt Text, deren Ausrichtung auf DWRITE_TEXT_ALIGNMENT_LEADING, DWRITE_TEXT_ALIGNMENT_CENTER bzw. DWRITE_TEXT_ALIGNMENT_TRAILING festgelegt ist.

Hinweis Die Ausrichtung ist von der Leserichtung abhängig, die obige ist für die Leserichtung von links nach rechts. Bei Leserichtung von rechts nach links wäre dies das Gegenteil.

 

Weitere Informationen finden Sie unter DWRITE_TEXT_ALIGNMENT .

Beispiele

if (SUCCEEDED(hr))
{
    hr = pTextFormat_->SetTextAlignment(DWRITE_TEXT_ALIGNMENT_CENTER);
}

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	dwrite.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

Idwritetextformat