Metodo ID2D1RenderTarget::D rawTextLayout (d2d1.h)

Disegna il testo formattato descritto dall'oggetto IDWriteTextLayout specificato.

Sintassi

void DrawTextLayout(
       D2D1_POINT_2F          origin,
  [in] IDWriteTextLayout      *textLayout,
  [in] ID2D1Brush             *defaultFillBrush,
       D2D1_DRAW_TEXT_OPTIONS options
);

Parametri

origin

Tipo: D2D1_POINT_2F

Il punto, descritto in pixel indipendenti dal dispositivo, in corrispondenza del quale viene disegnato l'angolo superiore sinistro del testo descritto da textLayout .

[in] textLayout

Tipo: IDWriteTextLayout*

Testo formattato da disegnare. Tutti gli effetti di disegno che non ereditano da ID2D1Resource vengono ignorati. Se sono presenti effetti di disegno che ereditano da ID2D1Resource che non sono pennelli, questo metodo ha esito negativo e la destinazione di rendering viene inserita in uno stato di errore.

[in] defaultFillBrush

Tipo: ID2D1Brush*

Pennello usato per disegnare qualsiasi testo in textLayout che non ha già un pennello associato a esso come effetto di disegno (specificato dal metodo IDWriteTextLayout::SetDrawingEffect ).

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.

Valore restituito

nessuno

Osservazioni

Quando si disegna ripetutamente lo stesso testo, l'uso del metodo DrawTextLayout è più efficiente rispetto all'uso del metodo DrawText perché il testo non deve essere formattato e il layout elaborato con ogni chiamata.

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

Requisiti

Vedi anche

ID2D1RenderTarget

Formattazione e layout del testo