Partilhar via


CDC::GetOutputTabbedTextExtent

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

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

Parâmetros

  • lpszString
    Aponta para uma seqüência de caractere a ser medido.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 a ser medido.

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 GetOutputTabbedTextExtent 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 médio de larguras de caractere.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.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDC

Gráfico de hierarquia

CDC::GetTextExtent

CDC::m_hAttribDC

CDC::m_hDC

CDC::GetTabbedTextExtent

CDC::GetOutputTextExtent

CDC::TabbedTextOut

GetTabbedTextExtent

Classe CSize

Outros recursos

Membros do CDC