ID2D1DeviceContext4::D rawTextLayout-Methode (d2d1_3.h)

  • Artikel

Zeichnet ein Textlayoutobjekt. Wenn das Layout nicht nachträglich geändert wird, kann dies effizienter sein als DrawText beim wiederholten Zeichnen desselben Layouts.

Syntax

void DrawTextLayout(
                 D2D1_POINT_2F          origin,
  [in]           IDWriteTextLayout      *textLayout,
  [in, optional] ID2D1Brush             *defaultFillBrush,
  [in, optional] ID2D1SvgGlyphStyle     *svgGlyphStyle,
                 UINT32                 colorPaletteIndex,
                 D2D1_DRAW_TEXT_OPTIONS options
);

Parameter

origin

Typ: D2D1_POINT_2F

Der Punkt, der in geräteunabhängigen Pixeln beschrieben wird, an dem die obere linke Ecke des durch textLayout beschriebenen Texts gezeichnet wird.

[in] textLayout

Typ: IDWriteTextLayout*

Der formatierte Text, der gezeichnet werden soll. Alle Zeichnungseffekte, die nicht von ID2D1Resource erben, werden ignoriert. Wenn Zeicheneffekte vorhanden sind, die von ID2D1Resource erben, die keine Pinsel sind, schlägt diese Methode fehl, und das Renderziel wird in einen Fehlerzustand versetzt.

[in, optional] defaultFillBrush

Typ: ID2D1Brush*

Der Pinsel zum Zeichnen des Texts.

[in, optional] svgGlyphStyle

Typ: ID2D1SvgGlyphStyle*

Die Werte für Kontextfüllen, Kontextstriche 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.

Rückgabewert

Keine

Anforderungen

   
Zielplattform Windows
Kopfzeile d2d1_3.h
DLL D2d1.dll

Weitere Informationen

ID2D1DeviceContext4