Compartilhar via


CDC::GetTabbedTextExtent

Chamar essa função de membro para calcular a largura e altura de uma cadeia de caracteres usando m_hAttribDC, o contexto do dispositivo de atributo.

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 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. Se nCount é – 1, o comprimento é calculado.

  • nTabPositions
    Especifica o número de posições de tabulação na matriz apontada por lpnTabStopPositions.

  • lpnTabStopPositions
    Aponta para uma matriz de inteiros que contêm as posições de tabulação em unidades lógicas. Paradas de tabulação devem ser classificadas na ordem crescente; o raio o menor valor deve ser o primeiro item na matriz. Não são permitidos para guias novamente.

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

Valor de retorno

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

Comentários

Se a cadeia de caracteres contém um ou mais caracteres de tabulação, a largura da cadeia de caracteres é baseada nas paradas de tabulação especificadas por lpnTabStopPositions. A função usa a fonte selecionada para calcular as dimensões da cadeia de caracteres.

A região recortada atual não muda a largura e altura retornadas pela função de GetTabbedTextExtent .

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

Se nTabPositions é 0 e lpnTabStopPositions é NULO, as guias são expandidos a oito vezes a largura de caractere intermediária. Se nTabPositions é 1, paradas de tabulação serão separados pela distância especificada pelo primeiro valor na matriz lpnTabStopPositions que aponta. Se os pontos de lpnTabStopPositions a mais de um único valor, uma parada de tabulação são definidos para cada valor na matriz, até o número especificado por nTabPositions.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico da hierarquia

CDC::GetTextExtent

CDC::GetOutputTabbedTextExtent

CDC::GetOutputTextExtent

CDC::TabbedTextOut

GetTabbedTextExtent

Classe CSize