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

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

Weitere Informationen

Idwritetextlayout