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