CDC::GetTabbedTextExtent

Artigo
08/25/2010

Chamar essa função de membro para calcular a largura e altura de uma seqüência de caractere usando m_hAttribDC, o atributo de contexto de dispositivo.

CSize GetTabbedTextExtent(
   LPCTSTR lpszString,
   int nCount,
   int nTabPositions,
   LPINT lpnTabStopPositions 
) const;
CSize GetTabbedTextExtent(
   const CString& str,
   int nTabPositions,
   LPINT lpnTabStopPositions 
) const;

Parâmetros

lpszString
Aponta para uma seqüência de caractere.Você também pode passar um CString objeto para esse parâmetro.
nCount
Especifica o número de caracteres na seqüência de caracteres.If nCount é – 1, o comprimento é calculado.
nTabPositions
Especifica o número de guia - parar posições na matriz apontada por lpnTabStopPositions.
lpnTabStopPositions
Aponta para uma matriz de inteiros que contém o guia-parar posições nas unidades lógicas.O guia paradas devem ser classificadas em ordem crescente; o menor valor de x deve ser o primeiro item na matriz.Back guias não são permitidas.
str
A CString objeto que contém os caracteres especificados ser desenhado.

Valor de retorno

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

Comentários

Se a seqüência de caracteres contém um ou mais guia caracteres, a largura da seqüência de caracteres baseia-se se o guia paradas especificadas por lpnTabStopPositions. A função usa a fonte atualmente selecionada para calcular as dimensões da seqüência de caracteres.

A região de recorte corrente não offset a largura e altura retornado pelo GetTabbedTextExtent função.

Já que alguns dispositivos não colocar caracteres em matrizes de célula normal (ou seja, eles kerning de caracteres), 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.

If nTabPositions é 0 e lpnTabStopPositions é NULO, as guias são expandidas para oito vezes a largura de caractere médio.If nTabPositions é 1, o guia paradas serão separadas pela distância especificada pelo valor do primeiro na matriz ao qual lpnTabStopPositions pontos. If lpnTabStopPositions pontos a mais de um único valor, uma parada de tabulação é definida para cada valor em array, até o número especificado pela nTabPositions.