Freigeben über


IDWriteTextFormat-Schnittstelle (dwrite.h)

Die IDWriteTextFormat-Schnittstelle beschreibt die Schriftart- und Absatzeigenschaften, die zum Formatieren von Text verwendet werden, und beschreibt Gebietsschemainformationen.

Vererbung

Die IDWriteTextFormat-Schnittstelle erbt von der IUnknown-Schnittstelle . IDWriteTextFormat verfügt auch über die folgenden Membertypen:

Methoden

Die IDWriteTextFormat-Schnittstelle verfügt über diese Methoden.

 
IDWriteTextFormat::GetFlowDirection

Ruft die Richtung ab, in die Textzeilen fließen.
IDWriteTextFormat::GetFontCollection

Ruft die aktuelle Schriftartsammlung ab.
IDWriteTextFormat::GetFontFamilyName

Ruft eine Kopie des Schriftfamiliennamens ab.
IDWriteTextFormat::GetFontFamilyNameLength

Ruft die Länge des Schriftfamiliennamens ab.
IDWriteTextFormat::GetFontSize

Ruft den Schriftgrad in DIP-Einheiten ab.
IDWriteTextFormat::GetFontStretch

Ruft den Schriftgrad des Texts ab.
IDWriteTextFormat::GetFontStyle

Ruft die Schriftart des Texts ab.
IDWriteTextFormat::GetFontWeight

Ruft die Schriftgrad des Texts ab.
IDWriteTextFormat::GetIncrementalTabStop

Ruft die inkrementelle Tabstoppposition ab.
IDWriteTextFormat::GetLineSpacing

Ruft den Zeilenabstandsanpassungssatz für einen mehrzeiligen Textabsatz ab. (IDWriteTextFormat.GetLineSpacing)
IDWriteTextFormat::GetLocaleName

Ruft eine Kopie des Gebietsschemanamens ab.
IDWriteTextFormat::GetLocaleNameLength

Ruft die Länge des Gebietsschemanamens ab.
IDWriteTextFormat::GetParagraphAlignment

Ruft die Ausrichtungsoption eines Absatzes ab, der relativ zum oberen und unteren Rand eines Layoutfelds ist.
IDWriteTextFormat::GetReadingDirection

Ruft die aktuelle Leserichtung für Text in einem Absatz ab.
IDWriteTextFormat::GetTextAlignment

Ruft die Ausrichtungsoption für Text relativ zum vor- und nachgestellten Rand des Layoutfelds ab.
IDWriteTextFormat::GetTrimming

Ruft die Kürzungsoptionen für Text ab, der das Layoutfeld überläuft.
IDWriteTextFormat::GetWordWrapping

Ruft die Wortumbruchoption ab.
IDWriteTextFormat::SetFlowDirection

Legt die Absatzflussrichtung fest.
IDWriteTextFormat::SetIncrementalTabStop

Legt einen festen Abstand zwischen zwei benachbarten Tabstopps fest.
IDWriteTextFormat::SetLineSpacing

Legt den Zeilenabstand fest.
IDWriteTextFormat::SetParagraphAlignment

Legt die Ausrichtungsoption eines Absatzes relativ zum oberen und unteren Rand des Layoutfelds fest.
IDWriteTextFormat::SetReadingDirection

Legt die Absatzleserichtung fest.
IDWriteTextFormat::SetTextAlignment

Legt die Ausrichtung von Text in einem Absatz relativ zum führenden und nachfolgenden Rand eines Layoutfelds für eine IDWriteTextFormat-Schnittstelle fest.
IDWriteTextFormat::SetTrimming

Legt Die Zuschneideoptionen für Text fest, der die Layoutbreite überläuft.
IDWriteTextFormat::SetWordWrapping

Legt die Wortumbruchoption fest.

Hinweise

Um einen Verweis auf die IDWriteTextFormat-Schnittstelle abzurufen, muss die Anwendung die IDWriteFactory::CreateTextFormat-Methode aufrufen, wie im folgenden Code gezeigt.


if (SUCCEEDED(hr))
{
    hr = pDWriteFactory_->CreateTextFormat(
        L"Gabriola",
        NULL,
        DWRITE_FONT_WEIGHT_REGULAR,
        DWRITE_FONT_STYLE_NORMAL,
        DWRITE_FONT_STRETCH_NORMAL,
        72.0f,
        L"en-us",
        &pTextFormat_
        );
}


Beim Erstellen eines IDWriteTextFormat-Objekts mit der CreateTextFormat-Funktion gibt die Anwendung die Schriftfamilie, die Schriftartsammlung, die Schriftstärke, den Schriftgrad und den Gebietsschemanamen für das Textformat an.

Diese Eigenschaften können nicht geändert werden, nachdem das IDWriteTextFormat-Objekt erstellt wurde. Um diese Eigenschaften zu ändern, muss ein neues IDWriteTextFormat-Objekt mit den gewünschten Eigenschaften erstellt werden.

Die IDWriteTextFormat-Schnittstelle wird verwendet, um Text mit einem einzigen Format zu zeichnen.

Verwenden Sie die IDWriteTextLayout-Schnittstelle , um Text mit mehreren Formaten zu zeichnen oder einen benutzerdefinierten Textrenderer zu verwenden. MIT IDWriteTextLayout kann die Anwendung das Format für Textbereiche innerhalb der Zeichenfolge ändern. IDWriteFactory::CreateTextLayout verwendet ein IDWriteTextFormat-Objekt als Parameter und wendet die Formatinformationen zunächst auf die gesamte Zeichenfolge an.

Dieses Objekt ist möglicherweise nicht threadsicher und trägt möglicherweise den Zustand der Textformatänderung.

DirectWrite und Direct2D

Um einfachen Text mit einem einzelnen Format zu zeichnen, stellt Direct2D die ID2D1RenderTarget::D rawText-Methode bereit, die eine Zeichenfolge mit den Formatinformationen eines IDWriteTextFormat-Objekts zeichnet.

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