Metodo IDWriteTextLayout::D raw (dwrite.h)

Disegna testo usando il contesto di disegno client specificato.

Sintassi

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

Parametri

clientDrawingContext

Tipo: void*

Contesto di disegno definito dall'applicazione.

renderer

Tipo: IDWriteTextRenderer*

Puntatore al set di funzioni di callback usate per disegnare parti di una stringa di testo.

originX

Tipo: FLOAT

Coordinata x del lato sinistro del layout.

originY

Tipo: FLOAT

Coordinata y del lato superiore del layout.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per disegnare testo con questo metodo, è necessario creare un oggetto textLayout usando IDWriteFactory::CreateTextLayout.

Dopo aver ottenuto l'oggetto textLayout , l'applicazione chiama il metodo IDWriteTextLayout::D raw per disegnare il testo, le decorazioni e gli oggetti inline. Il disegno effettivo viene eseguito tramite l'interfaccia callback passata come argomento textRenderer ; l'API DrawGlyphRun corrispondente viene chiamata.

Se si imposta una direzione di lettura del testo verticale su IDWriteTextLayout tramite SetReadingDirection con DWRITE_READING_DIRECTION_TOP_TO_BOTTOM (o in basso verso l'alto), è necessario passare un'interfaccia che implementa IDWriteTextRenderer1. In caso contrario, viene visualizzato l'errore DWRITE_E_TEXTRENDERERINCOMPATIBLE perché l'interfaccia IDWriteTextRenderer originale è supportata solo in testo orizzontale.

Requisiti

   
Client minimo supportato Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione dwrite.h
Libreria Dwrite.lib
DLL Dwrite.dll

Vedi anche

IDWriteTextLayout