CDC::TabbedTextOut
Chame essa função de membro para gravar uma Cadeia de Caracteres no local especificado, expandir guias com os valores especificados na matriz de posições de parada 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 de partida da Cadeia de Caracteres.y
Especifica a lógica coordenada y do ponto de partida da Cadeia de Caracteres.lpszString
Aponta para a Cadeia de Caracteres para desenhar.Você pode passar um ponteiro para uma matriz de caracteres ou um objeto de CString para este 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 parada de Guiaulação.lpnTabStopPositions
Aponta para uma matriz que contém as posições de parada de Guiaulação (em unidades lógicas).As paradas de Guiaulação devem ser classificadas em ordem; crescente menor valor de x deve ser o primeiro item na matriz.nTabOrigin
Especifica a coordenada x da posição inicial da qual guias são expandidas (nas unidades lógicas).str
Um objeto de CString que contém os caracteres especificados.
Valor de retorno
As dimensões da Cadeia de Caracteres (nas unidades lógicas) como um objeto CSize.
Comentários
Texto é escrito na fonte selecionada no momento.Se nTabPositions é 0 e lpnTabStopPositions é NULL, as guias são expandidas para oito horas a largura de caractere médio.
Se nTabPositions for 1, as paradas de Guiaulação são separadas pela distância especificada pelo primeiro valor na matriz lpnTabStopPositions.Se a matriz de lpnTabStopPositions contém mais de um valor, uma parada de Guiaulação é definida para cada valor na matriz, backup para o número especificado por nTabPositions.O parâmetro nTabOrigin permite que um aplicativo chamar a função TabbedTextOut várias vezes para um Simples linha.Se o aplicativo chama a função mais de uma vez com nTabOrigin definido com o mesmo valor cada vez, a função expande todas as guias Relativo à posição especificada por nTabOrigin.
Por padrão, a posição atual não é usada ou atualizada pela função.Se um aplicativo precisa atualizar a posição atual quando ele chama a função, o aplicativo pode chamar o função de membro SetTextAlign com nFlags definido como TA_UPDATECP.Quando esse Sinalizar estiver definido, o Windows ignora o x e y parâmetros em chamadas subseqüentes a TabbedTextOut, usando a posição atual em seu lugar.
Requisitos
Cabeçalho: afxwin.h