ID2D1DeviceContext4::D rawText(constWCHAR*,UINT32,IDWriteTextFormat*,constD2D1_RECT_F&,ID2D1Brush*,ID2D1SvgGlyphStyle*,UINT32,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE)-Methode (d2d1_3.h)

  • Artikel

Zeichnet den Text innerhalb des angegebenen Layoutrechtecks.

Standardmäßig führt diese Methode das Baseline-Snapping aus und rendert Farbversionen von Glyphen in Farbschriftarten.

Syntax

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

Parameter

[in] string

Typ: const WCHAR*

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

stringLength

Typ: UINT32

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, optional] defaultFillBrush

Typ: ID2D1Brush*

Der Pinsel zum Zeichnen des Texts.

[in, optional] svgGlyphStyle

Typ: ID2D1SvgGlyphStyle*

Werte für Kontextfüllung, Kontextstrich und Kontextwert, die beim Rendern von SVG-Glyphen verwendet werden.

colorPaletteIndex

Typ: UINT32

Der Index, der zum Auswählen einer Farbpalette innerhalb einer Farbschriftart verwendet wird.

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

Anforderungen

   
Zielplattform Windows
Kopfzeile d2d1_3.h
DLL D2d1.dll

Weitere Informationen

ID2D1DeviceContext4