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

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,
  [ref] 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.

[ref] 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, 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

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

DWRITE_MEASURING_MODE

DrawTextLayout

Como desenhar texto

ID2D1RenderTarget

Formatação e Layout de Texto