IDWriteTextLayout::D raw-Methode (dwrite.h)

  • Artikel

Zeichnet Text mithilfe des angegebenen Clientzeichnungskontexts.

Syntax

HRESULT Draw(
  void                *clientDrawingContext,
  IDWriteTextRenderer *renderer,
  FLOAT               originX,
  FLOAT               originY
);

Parameter

clientDrawingContext

Typ: void*

Ein anwendungsdefinierter Zeichnungskontext.

renderer

Typ: IDWriteTextRenderer*

Zeiger auf den Satz von Rückruffunktionen, die zum Zeichnen von Teilen einer Textzeichenfolge verwendet werden.

originX

Typ: FLOAT

Die x-Koordinate der linken Seite des Layouts.

originY

Typ: FLOAT

Die y-Koordinate der oberen Seite des Layouts.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Um Text mit dieser Methode zu zeichnen, muss ein textLayout-Objekt von der Anwendung mit IDWriteFactory::CreateTextLayout erstellt werden.

Nachdem das textLayout-Objekt abgerufen wurde, ruft die Anwendung die IDWriteTextLayout::D raw-Methode auf, um die Text-, Dekorations- und Inlineobjekte zu zeichnen. Die eigentliche Zeichnung erfolgt über die Rückrufschnittstelle, die als textRenderer-Argument übergeben wird. dort wird die entsprechende DrawGlyphRun-API aufgerufen.

Wenn Sie eine vertikale Textleserichtung für IDWriteTextLayout über SetReadingDirection mit DWRITE_READING_DIRECTION_TOP_TO_BOTTOM (oder unten nach oben) festlegen, müssen Sie eine Schnittstelle übergeben, die IDWriteTextRenderer1 implementiert. Andernfalls erhalten Sie den Fehler DWRITE_E_TEXTRENDERERINCOMPATIBLE, da die ursprüngliche IDWriteTextRenderer-Schnittstelle nur horizontalen Text unterstützte.

Anforderungen

   
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 dwrite.h
Bibliothek Dwrite.lib
DLL Dwrite.dll

Weitere Informationen

Idwritetextlayout