ID2D1RenderTarget::D rawTextLayout-Methode (d2d1.h)
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
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 |