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 de hierarquia

CDC::GetTextExtent

CDC::m_hAttribDC

CDC::m_hDC

CDC::GetTabbedTextExtent

CDC::GetOutputTextExtent

CDC::TabbedTextOut

GetTabbedTextExtent

Classe de CSize