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
| 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 |