Método ID2D1RenderTarget::D rawTextLayout (d2d1.h)
Dibuja el texto con formato descrito por el objeto IDWriteTextLayout especificado.
Sintaxis
void DrawTextLayout(
D2D1_POINT_2F origin,
[in] IDWriteTextLayout *textLayout,
[in] ID2D1Brush *defaultFillBrush,
D2D1_DRAW_TEXT_OPTIONS options
);
Parámetros
origin
Tipo: D2D1_POINT_2F
El punto, que se describe en píxeles independientes del dispositivo, en el que se dibuja la esquina superior izquierda del texto descrito por textLayout .
[in] textLayout
Tipo: IDWriteTextLayout*
El texto con formato que se dibujará. Los efectos de dibujo que no heredan de ID2D1Resource se omiten. Si hay efectos de dibujo que heredan de ID2D1Resource que no son pinceles, este método produce un error y el destino de representación se coloca en un estado de error.
[in] defaultFillBrush
Tipo: ID2D1Brush*
Pincel usado para pintar cualquier texto de textLayout que aún no tenga un pincel asociado como efecto de dibujo (especificado por el método IDWriteTextLayout::SetDrawingEffect ).
options
Tipo: D2D1_DRAW_TEXT_OPTIONS
Un valor que indica si el texto se debe acoplar a los límites de píxeles y si el texto se debe recortar según el rectángulo de diseño. El valor predeterminado es D2D1_DRAW_TEXT_OPTIONS_NONE, lo que indica que el texto se debe ajustar a los límites de píxeles y no debe recortarse en el rectángulo de diseño.
Valor devuelto
None
Observaciones
Cuando se dibuja repetidamente el mismo texto, el uso del método DrawTextLayout es más eficaz que usar el método DrawText porque no es necesario dar formato al texto y el diseño procesado con cada llamada.
Este método no devuelve un código de error si se produce un error. Para determinar si se produjo un error en una operación de dibujo (como DrawTextLayout), compruebe el resultado devuelto por los métodos ID2D1RenderTarget::EndDraw o ID2D1RenderTarget::Flush .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | d2d1.h |
| Library | D2d1.lib |
| Archivo DLL | D2d1.dll |