Freigeben über


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.

Abbildung von Textabsätzen mit vorangestellter, zentrierter und nachgestellter Ausrichtung
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