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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de