Função GetTextMetricsW (wingdi.h)

Artigo
03/13/2024

A função GetTextMetrics preenche o buffer especificado com as métricas para a fonte selecionada no momento.

Sintaxe

BOOL GetTextMetricsW(
  [in]  HDC           hdc,
  [out] LPTEXTMETRICW lptm
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[out] lptm

Um ponteiro para a estrutura TEXTMETRIC que recebe as métricas de texto.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Para determinar se uma fonte é uma fonte TrueType, primeiro selecione-a em um DC, depois chame GetTextMetrics e, em seguida, marcar para TMPF_TRUETYPE em TEXTMETRIC.tmPitchAndFamily. Observe que GetDC retorna um DC não inicializado, que tem "System" (uma fonte bitmap) como a fonte padrão; portanto, a necessidade de selecionar uma fonte no DC.

Exemplos

Para obter um exemplo, confira "Exibindo entrada de teclado" em Usando entrada de teclado ou texto de desenho de fontes diferentes na mesma linha.

Observação

O cabeçalho wingdi.h define GetTextMetrics como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll