Metodo ID2D1RenderTarget::D rawText(constWCHAR,UINT32,IDWriteTextFormat,constD2D1_RECT_F&,ID2D1Brush*,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE) (d2d1.h)

Articolo
08/22/2023

Disegna il testo specificato utilizzando le informazioni sul formato fornite da un oggetto IDWriteTextFormat .

Sintassi

void DrawText(
  [in]  const WCHAR            *string,
        UINT32                 stringLength,
  [in]  IDWriteTextFormat      *textFormat,
  [ref] const D2D1_RECT_F &    layoutRect,
  [in]  ID2D1Brush             *defaultFillBrush,
        D2D1_DRAW_TEXT_OPTIONS options,
        DWRITE_MEASURING_MODE  measuringMode
);

Parametri

[in] string

Tipo: WCHAR*

Puntatore a una matrice di caratteri Unicode da disegnare.

stringLength

Tipo: UINT

Numero di caratteri nella stringa.

[in] textFormat

Tipo: IDWriteTextFormat*

Oggetto che descrive i dettagli di formattazione del testo da disegnare, ad esempio il tipo di carattere, le dimensioni del carattere e la direzione del flusso.

[ref] layoutRect

Tipo: const D2D1_RECT_F

Dimensioni e posizione dell'area in cui viene disegnato il testo.

[in] defaultFillBrush

Tipo: ID2D1Brush*

Pennello utilizzato per disegnare il testo.

options

Tipo: D2D1_DRAW_TEXT_OPTIONS

Valore che indica se il testo deve essere ritagliato ai limiti pixel e se il testo deve essere ritagliato nel rettangolo di layout. Il valore predefinito è D2D1_DRAW_TEXT_OPTIONS_NONE, che indica che il testo deve essere ritagliato ai limiti pixel e non deve essere ritagliato nel rettangolo di layout.

measuringMode

Tipo: DWRITE_MEASURING_MODE

Valore che indica come vengono usate le metriche del glifo per misurare il testo quando viene formattato. Il valore predefinito è DWRITE_MEASURING_MODE_NATURAL.

Valore restituito

nessuno

Osservazioni

Per creare un oggetto IDWriteTextFormat , creare un OGGETTO IDWriteFactory e chiamarne il metodo CreateTextFormat .

Questo metodo non restituisce un codice di errore in caso di errore. Per determinare se un'operazione di disegno (ad esempio DrawText) non è riuscita, controllare il risultato restituito dai metodi ID2D1RenderTarget::EndDraw o ID2D1RenderTarget::Flush .

Esempio

Per un esempio, vedere Procedura: Disegnare testo.

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	d2d1.h
Libreria	D2d1.lib
DLL	D2d1.dll