Partilhar via


CDC::GetOutputTabbedTextExtent

Chamar essa função de membro para calcular a largura e altura de uma cadeia de caracteres usando m_hDC, o contexto do 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 cadeia de caracteres a ser medida. 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 os caracteres a ser especificados medidos.

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 GetOutputTabbedTextExtent .

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 largura de oito caracteres médias. 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::m_hAttribDC

CDC::m_hDC

CDC::GetTabbedTextExtent

CDC::GetOutputTextExtent

CDC::TabbedTextOut

GetTabbedTextExtent

Classe CSize