IDWriteTextFormat-Schnittstelle (dwrite.h)

Artikel
08/23/2023

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

Freigeben über