Partilhar via


CDC::GetTextExtent

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

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

Parâmetros

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

  • nCount
    Especifica o número de caracteres na cadeia de caracteres.

  • str
    Um objeto de CString que contém caracteres especificados.

Valor de retorno

As dimensões da cadeia de caracteres (em unidades lógicas) em um objeto de CSize .

Comentários

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

Por padrão, GetTextExtent assume que o texto para que recupera a dimensão é definido ao longo de uma linha horizontal (isto é, o escape é 0).Se você criar uma fonte que especifica um escape diferente de zero, você deve converter o ângulo de texto explicitamente para obter as dimensões da cadeia de caracteres.

A região recortada atual não afeta a largura e altura retornadas por GetTextExtent.

Desde que alguns dispositivos não colocam caracteres em matrizes da célula normais (isto é, realizam a crenagem), a soma das extensões de caracteres em uma cadeia de caracteres não pode ser igual a extensão de cadeia de caracteres.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico de hierarquia

CDC::GetTabbedTextExtent

CDC::m_hAttribDC

CDC::m_hDC

CDC::GetOutputTextExtent

CDC::SetTextJustification

Classe de CSize