ID2D1RenderTarget::D rawTextLayout-Methode (d2d1.h)

  • Artikel

Zeichnet den formatierten Text, der vom angegebenen IDWriteTextLayout-Objekt beschrieben wird.

Syntax

void DrawTextLayout(
       D2D1_POINT_2F          origin,
  [in] IDWriteTextLayout      *textLayout,
  [in] ID2D1Brush             *defaultFillBrush,
       D2D1_DRAW_TEXT_OPTIONS options
);

Parameter

origin

Typ: D2D1_POINT_2F

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

[in] textLayout

Typ: IDWriteTextLayout*

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

[in] defaultFillBrush

Typ: ID2D1Brush*

Der Pinsel zum Zeichnen von Text in textLayout , dem noch kein Pinsel als Zeichnungseffekt zugeordnet ist (angegeben durch die IDWriteTextLayout::SetDrawingEffect-Methode ).

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 abgeschnitten werden soll. Der Standardwert ist D2D1_DRAW_TEXT_OPTIONS_NONE, was angibt, dass Text an Pixelgrenzen angedockt und nicht an das Layoutrechteck gekappt werden soll.

Rückgabewert

Keine

Bemerkungen

Wenn Sie denselben Text wiederholt zeichnen, ist die Verwendung der DrawTextLayout-Methode effizienter als die Verwendung der DrawText-Methode , da der Text nicht formatiert und das Layout bei jedem Aufruf verarbeitet werden muss.

Diese Methode gibt keinen Fehlercode zurück, wenn sie fehlschlägt. Überprüfen Sie das Ergebnis, das von den Methoden ID2D1RenderTarget::EndDraw oder ID2D1RenderTarget::Flush zurückgegeben wird, um festzustellen, ob bei einem Zeichnungsvorgang (z. B. DrawTextLayout) ein Fehler aufgetreten ist.

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

ID2D1RenderTarget

Textformatierung und Layout