CDC::TabbedTextOut

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 CDCMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CDC::GetTabbedTextExtent, CDC::SetTextAlign, CDC::TextOut, CDC::SetTextColor, :: TabbedTextOut, CSize

Index