ID2D1RenderTarget::D rawText(constWCHAR*,UINT32,IDWriteTextFormat*,constD2D1_RECT_F*,ID2D1Brush*,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE)-Methode (d2d1.h)
Zeichnet den angegebenen Text mit den Formatinformationen eines IDWriteTextFormat-Objekts .
Syntax
void DrawText(
[in] const WCHAR *string,
UINT32 stringLength,
[in] IDWriteTextFormat *textFormat,
[in] 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.
[in] 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
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
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
Anforderung | Wert |
---|---|
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 |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für