Compartilhar via


Função GetTextMetrics (wingdi.h)

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

Sintaxe

BOOL GetTextMetrics(
  [in]  HDC          hdc,
  [out] LPTEXTMETRIC 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.

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

Confira também

Funções de fonte e texto

Visão geral de fontes e texto

GetTextAlign

Gettextextentpoint32

GetTextFace

Settextjustification

TEXTMETRIC