Método ID2D1RenderTarget::D rawText(constWCHAR,UINT32,IDWriteTextFormat,constD2D1_RECT_F,ID2D1Brush,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE) (d2d1.h)

2024-02-26

Desenha o texto especificado usando as informações de formato fornecidas por um objeto IDWriteTextFormat .

Sintaxe

void DrawText(
  [in] const WCHAR            *string,
       UINT32                 stringLength,
  [in] IDWriteTextFormat      *textFormat,
  [in] const D2D1_RECT_F      *layoutRect,
  [in] ID2D1Brush             *defaultFillBrush,
       D2D1_DRAW_TEXT_OPTIONS options,
       DWRITE_MEASURING_MODE  measuringMode
);

Parâmetros

[in] string

Tipo: WCHAR*

Um ponteiro para uma matriz de caracteres Unicode a ser desenhada.

stringLength

Tipo: UINT

O número de caracteres na cadeia de caracteres.

[in] textFormat

Tipo: IDWriteTextFormat*

Um objeto que descreve os detalhes de formatação do texto a ser desenhado, como a fonte, o tamanho da fonte e a direção do fluxo.

[in] layoutRect

Tipo: const D2D1_RECT_F*

O tamanho e a posição da área em que o texto é desenhado.

[in] defaultFillBrush

Tipo: ID2D1Brush*

O pincel usado para pintar o texto.

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, o que indica que o texto deve ser ajustado para limites de pixel e não deve ser recortado no retângulo de layout.

measuringMode

Tipo: DWRITE_MEASURING_MODE

Um valor que indica como as métricas de glifo são usadas para medir o texto, quando formatado. O valor padrão é DWRITE_MEASURING_MODE_NATURAL.

Retornar valor

Nenhum

Comentários

Para criar um objeto IDWriteTextFormat , crie um IDWriteFactory e chame seu método CreateTextFormat .

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

Exemplos

Para obter um exemplo, consulte Como desenhar texto.

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 Atualização de Plataforma 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