Compartilhar via


CDC::TabbedTextOut

Chamar essa função de membro para gravar uma cadeia de caracteres no local especificado, expandindo guias aos valores especificados na matriz de posições de tabulação.

virtual CSize TabbedTextOut(
   int x,
   int y,
   LPCTSTR lpszString,
   int nCount,
   int nTabPositions,
   LPINT lpnTabStopPositions,
   int nTabOrigin 
);
CSize TabbedTextOut(
   int x,
   int y,
   const CString& str,
   int nTabPositions,
   LPINT lpnTabStopPositions,
   int nTabOrigin 
);

Parâmetros

  • x
    Especifica a lógica coordenada x do ponto inicial da cadeia de caracteres.

  • s
    Especifica a coordenada y lógica do ponto inicial da cadeia de caracteres.

  • lpszString
    Pontos a cadeia de caracteres para desenhar.Você pode passar um ponteiro para uma matriz de caracteres ou 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 valores na matriz de posições de tabulação.

  • lpnTabStopPositions
    Aponta para uma matriz 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.

  • nTabOrigin
    Especifica a coordenada x da posição inicial de que as guias são expandidos (em unidades lógicas).

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

Valor de retorno

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

Comentários

O texto escrito na fonte selecionada.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 são separadas pela distância especificada pelo primeiro valor na matriz de lpnTabStopPositions .Se a matriz de lpnTabStopPositions contém mais de um valor, uma parada de tabulação é definida para cada valor na matriz, até o número especificado por nTabPositions.O parâmetro de nTabOrigin permite que um aplicativo chamar a função de TabbedTextOut várias vezes para uma única linha.Se o aplicativo chama a função mais de uma vez nTabOrigin definido com o mesmo valor cada vez, a função expande todas as guias relativo a posição especificada por nTabOrigin.

Por padrão, a posição atual não é usado ou não é atualizado pela função.Se um aplicativo precisar atualizar a posição atual quando chama a função, o aplicativo pode chamar a função de membro de SetTextAlign com nFlags definido como TA_UPDATECP.Quando esse sinalizador é definido, o windows ignora os parâmetros de x e y em chamadas subseqüentes a TabbedTextOut, usando a posição atual em vez de isso.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico de hierarquia

CDC::GetTabbedTextExtent

CDC::SetTextAlign

CDC::TextOut

CDC::SetTextColor

TabbedTextOut

Classe de CSize