virtual CSize TabbedTextOut ( int x, int y, LPCTSTR lpszString, int nCount, int nTabPositions, LPINT lpnTabStopPositions, int nTabOrigin );
CSize T&abbedTextOut (int x, int yCStringamp const;Str, int nTabPositionsLPINTlpnTabStopPositions, int nTabOrigin );
Valor de retorno
As dimensões da Cadeia de caracteres (nas unidades lógicas) como um objeto CSize.
Parâmetros
x
Especifica a lógica coordenada x do ponto inicial da Cadeia de caracteres.
y
Especifica a lógica coordenada y do ponto inicial 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 tabulação.
lpnTabStopPositions
Aponta para uma matriz que contém as posições de parada de Guiaulação (em unidades lógicas). As paradas de tabulação devem ser classificadas em ordem; o menor valor de x deve ser o primeiro item na matriz.
nTabOrigin
Especifica a coordenada x da posição inicial do qual as guias são expandidas (em unidades lógicas).
str
Um objeto de CString que contém os caracteres especificados.
Observações
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 Guiaulação. O texto é escrito na fonte selecionada no momento. Se nTabPositions é 0 e lpnTabStopPositions é NULL, as guias são expandidas para oito vezes 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 uma única 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 para a 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 a função de membro SetTextAlign com nFlags definido como TA_UPDATECP. Quando este sinalizador estiver definido, o Windows ignora os parâmetros de x e y em chamadas subseqüentes para TabbedTextOut, usando a posição atual em vez disso.
Visão geral do CDC | Membros de classe | Gráfico de hierarquia
Consulte tambémnbsp;CDC::GetTabbedTextExtent, CDC::SetTextAlign, CDC::TextOut, CDC::SetTextColor, :: TabbedTextOut, CSize