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

Consulte también

ID2D1RenderTarget

Formato y diseño de texto