ID2D1RenderTarget::D rawText(constWCHAR,UINT32,IDWriteTextFormat,constD2D1_RECT_F&,ID2D1Brush*,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE)-Methode (d2d1.h)

Artikel
01/10/2024

Zeichnet den angegebenen Text mit den Formatinformationen eines IDWriteTextFormat-Objekts .

Syntax

void DrawText(
  [in]  const WCHAR            *string,
        UINT32                 stringLength,
  [in]  IDWriteTextFormat      *textFormat,
  [ref] const D2D1_RECT_F &    layoutRect,
  [in]  ID2D1Brush             *defaultFillBrush,
        D2D1_DRAW_TEXT_OPTIONS options,
        DWRITE_MEASURING_MODE  measuringMode
);

Parameter

[in] string

Typ: WCHAR*

Ein Zeiger auf ein Array von Unicode-Zeichen, die gezeichnet werden sollen.

stringLength

Typ: UINT

Die Anzahl der Zeichen in der Zeichenfolge.

[in] textFormat

Typ: IDWriteTextFormat*

Ein -Objekt, das Formatierungsdetails des zu zeichnenden Texts beschreibt, z. B. die Schriftart, den Schriftgrad und die Flussrichtung.

[ref] layoutRect

Typ: const D2D1_RECT_F

Die Größe und Position des Bereichs, in dem der Text gezeichnet wird.

[in] defaultFillBrush

Typ: ID2D1Brush*

Der Pinsel zum Zeichnen des Texts.

options

Typ: D2D1_DRAW_TEXT_OPTIONS

Ein Wert, der angibt, ob der Text an Pixelgrenzen angedockt werden soll und ob der Text an das Layoutrechteck gekappt werden soll. Der Standardwert ist D2D1_DRAW_TEXT_OPTIONS_NONE, was angibt, dass Text an Pixelgrenzen angedockt werden soll und nicht an das Layoutrechteck gekappt werden soll.

measuringMode

Typ: DWRITE_MEASURING_MODE

Ein Wert, der angibt, wie Glyphenmetriken zum Messen von Text verwendet werden, wenn er formatiert ist. Der Standardwert ist DWRITE_MEASURING_MODE_NATURAL.

Rückgabewert

Keine

Bemerkungen

Um ein IDWriteTextFormat-Objekt zu erstellen, erstellen Sie eine IDWriteFactory , und rufen Sie dessen CreateTextFormat-Methode auf.

Diese Methode gibt keinen Fehlercode zurück, wenn ein Fehler auftritt. Um zu ermitteln, ob bei einem Zeichnungsvorgang (z. B . DrawText) ein Fehler aufgetreten ist, überprüfen Sie das ergebnis, das von den Methoden ID2D1RenderTarget::EndDraw oder ID2D1RenderTarget::Flush zurückgegeben wird.

Beispiele

Ein Beispiel finden Sie unter Vorgehensweise: Zeichnen von Text.

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	d2d1.h
Bibliothek	D2d1.lib
DLL	D2d1.dll