Função TabbedTextOutA (winuser.h)

A função TabbedTextOut grava uma cadeia de caracteres em um local especificado, expandindo as guias para os valores especificados em uma matriz de posições de parada de tabulação. O texto é escrito na fonte, na cor do plano de fundo e na cor do texto selecionadas no momento.

Sintaxe

LONG TabbedTextOutA(
  [in] HDC       hdc,
  [in] int       x,
  [in] int       y,
  [in] LPCSTR    lpString,
  [in] int       chCount,
  [in] int       nTabPositions,
  [in] const INT *lpnTabStopPositions,
  [in] int       nTabOrigin
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] x

A coordenada x do ponto inicial da cadeia de caracteres, em unidades lógicas.

[in] y

A coordenada y do ponto inicial da cadeia de caracteres, em unidades lógicas.

[in] lpString

Um ponteiro para a cadeia de caracteres a ser desenhada. A cadeia de caracteres não precisa ser terminada em zero, pois nCount especifica o comprimento da cadeia de caracteres.

[in] chCount

O comprimento da cadeia de caracteres apontado por lpString.

[in] nTabPositions

O número de valores na matriz de posições de parada de tabulação.

[in] lpnTabStopPositions

Um ponteiro para uma matriz que contém as posições de parada de tabulação, em unidades lógicas. As paradas de tabulação devem ser classificadas em ordem crescente; o menor valor x deve ser o primeiro item na matriz.

[in] nTabOrigin

A coordenada x da posição inicial da qual as guias são expandidas, em unidades lógicas.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será as dimensões, em unidades lógicas, da cadeia de caracteres. A altura está na palavra de alta ordem e a largura está na palavra de ordem baixa.

Se a função falhar, o valor retornado será zero.

Observações

Se o parâmetro nTabPositions for zero e o parâmetro lpnTabStopPositions for NULL, as guias serão expandidas para oito vezes a largura média do caractere.

Se nTabPositions for 1, as paradas de tabulação serão separadas pela distância especificada pelo primeiro valor na matriz lpnTabStopPositions.

Se a matriz lpnTabStopPositions contiver mais de um valor, uma parada de tabulação será definida para cada valor na matriz, até o número especificado por nTabPositions.

O parâmetro nTabOrigin permite que um aplicativo chame a função TabbedTextOut várias vezes para uma única linha. Se o aplicativo chamar TabbedTextOut mais de uma vez com o nTabOrigin definido como o mesmo valor a cada vez, a função expandirá todas as guias relativas à posição especificada por nTabOrigin.

Por padrão, a posição atual não é usada ou atualizada pela função TabbedTextOut. Se um aplicativo precisar atualizar a posição atual ao chamar TabbedTextOut, o aplicativo poderá chamar a função SetTextAlign com o parâmetro wFlags definido como TA_UPDATECP. Quando esse sinalizador é definido, o sistema ignora os parâmetros X e Y em chamadas subsequentes para a função tabbedTextOut , usando a posição atual.

Requisitos

Consulte também

DrawText

Funções de fonte e texto

fontes e visão geral de texto

GetTabbedTextExtent

GrayString

SelectObject

SetBkColor

SetTextAlign

SetTextColor

textout