Compartilhar via


CDC::GetTextExtent

Chame essa função de membro para calcular a largura e altura de uma linha de texto usando a fonte corrente para determinar as dimensões.

CSize GetTextExtent(
   LPCTSTR lpszString,
   int nCount 
) const;
CSize GetTextExtent(
   const CString& str 
) const;

Parâmetros

  • lpszString
    Aponta para uma seqüência de caracteres.Você também pode passar um CString objeto para esse parâmetro.

  • nCount
    Especifica o número de caracteres na seqüência de caracteres.

  • str
    A CString objeto que contém os caracteres especificados.

Valor de retorno

As dimensões da seqüência de caracteres (em unidades lógicas) em um CSize objeto.

Comentários

As informações são recuperadas de m_hAttribDC, o atributo de contexto de dispositivo.

Por padrão, GetTextExtent assume o texto para o qual ele recupera a dimensão é definido ao longo de uma linha horizontal (ou seja, o escape é 0). Se você criar uma fonte especificando um escape de zero, você deve converter o ângulo do texto explicitamente para obter as dimensões da seqüência de caracteres.

A região de recorte corrente não afeta a largura e altura retornado por GetTextExtent.

Já que alguns dispositivos não colocar caracteres em matrizes de célula normal (ou seja, eles executar kerning), a soma de extensões de caracteres em uma seqüência de caracteres não pode ser igual a extensão da seqüência de caracteres.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDC

Gráfico de hierarquia

CDC::GetTabbedTextExtent

CDC::m_hAttribDC

CDC::m_hDC

CDC::GetOutputTextExtent

CDC::SetTextJustification

Classe CSize

Outros recursos

Membros do CDC