Método ID2D1RenderTarget::D rawTextLayout (d2d1.h)

Desenha o texto formatado descrito pelo objeto IDWriteTextLayout especificado.

Sintaxe

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

Parâmetros

origin

Tipo: D2D1_POINT_2F

O ponto, descrito em pixels independentes do dispositivo, no qual o canto superior esquerdo do texto descrito por textLayout é desenhado.

[in] textLayout

Tipo: IDWriteTextLayout*

O texto formatado a ser desenhado. Todos os efeitos de desenho que não herdam de ID2D1Resource são ignorados. Se houver efeitos de desenho que herdam de ID2D1Resource que não são pincéis, esse método falhará e o destino de renderização será colocado em um estado de erro.

[in] defaultFillBrush

Tipo: ID2D1Brush*

O pincel usado para pintar qualquer texto em textLayout que ainda não tenha um pincel associado a ele como um efeito de desenho (especificado pelo método IDWriteTextLayout::SetDrawingEffect ).

options

Tipo: D2D1_DRAW_TEXT_OPTIONS

Um valor que indica se o texto deve ser ajustado aos limites de pixel e se o texto deve ser recortado no retângulo de layout. O valor padrão é D2D1_DRAW_TEXT_OPTIONS_NONE, que indica que o texto deve ser ajustado para limites de pixel e não deve ser recortado no retângulo de layout.

Retornar valor

Nenhum

Comentários

Ao desenhar o mesmo texto repetidamente, usar o método DrawTextLayout é mais eficiente do que usar o método DrawText porque o texto não precisa ser formatado e o layout processado com cada chamada.

Esse método não retornará um código de erro se falhar. Para determinar se uma operação de desenho (como DrawTextLayout) falhou, marcar o resultado retornado pelos métodos ID2D1RenderTarget::EndDraw ou ID2D1RenderTarget::Flush.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	d2d1.h
Biblioteca	D2d1.lib
DLL	D2d1.dll

Confira também

ID2D1RenderTarget

Formatação e Layout de Texto