Função TextOutA (wingdi.h)

A função TextOut grava uma cadeia de caracteres no local especificado, usando a fonte, a cor da tela de fundo e a cor do texto selecionadas no momento.

Sintaxe

BOOL TextOutA(
  [in] HDC    hdc,
  [in] int    x,
  [in] int    y,
  [in] LPCSTR lpString,
  [in] int    c
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] x

A coordenada x, em coordenadas lógicas, do ponto de referência que o sistema usa para alinhar a cadeia de caracteres.

[in] y

A coordenada y, em coordenadas lógicas, do ponto de referência que o sistema usa para alinhar a cadeia de caracteres.

[in] lpString

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

[in] c

O comprimento da cadeia de caracteres apontada por lpString, em caracteres.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

A interpretação do ponto de referência depende do modo de alinhamento de texto atual. Um aplicativo pode recuperar esse modo chamando a função GetTextAlign ; um aplicativo pode alterar esse modo chamando a função SetTextAlign . Você pode usar os valores a seguir para alinhamento de texto. Somente um sinalizador pode ser escolhido daqueles que afetam o alinhamento horizontal e vertical. Além disso, apenas um dos dois sinalizadores que alteram a posição atual pode ser escolhido.

Por padrão, a posição atual não é usada ou atualizada por essa função. No entanto, um aplicativo pode chamar a função SetTextAlign com o parâmetro fMode definido como TA_UPDATECP para permitir que o sistema use e atualize a posição atual sempre que o aplicativo chamar TextOut para um contexto de dispositivo especificado. Quando esse sinalizador é definido, o sistema ignora os parâmetros nXStart e nYStart em chamadas TextOut subsequentes.

Quando a função TextOut é colocada dentro de um colchete de caminho, o sistema gera um caminho para o texto TrueType que inclui cada caractere mais sua caixa de caracteres. A região gerada é a caixa de caracteres menos o texto, em vez do texto em si. Você pode obter a região delimitada pela estrutura de tópicos do texto TrueType definindo o modo de plano de fundo como transparente antes de colocar a função TextOut no colchete de caminho. Veja a seguir o código de exemplo que demonstra esse procedimento.

// Obtain the window's client rectangle 
GetClientRect(hwnd, &r);

// THE FIX: by setting the background mode 
// to transparent, the region is the text itself 
// SetBkMode(hdc, TRANSPARENT); 

// Bracket begin a path 
BeginPath(hdc);

// Send some text out into the world 
TCHAR text[ ] = "Defenestration can be hazardous";
TextOut(hdc,r.left,r.top,text, ARRAYSIZE(text));

// Bracket end a path 
EndPath(hdc);

// Derive a region from that path 
SelectClipPath(hdc, RGN_AND);

// This generates the same result as SelectClipPath() 
// SelectClipRgn(hdc, PathToRegion(hdc)); 

// Fill the region with grayness 
FillRect(hdc, &r, GetStockObject(GRAY_BRUSH));

Exemplos

Para obter um exemplo, consulte Enumerando as fontes instaladas.

Requisitos

Confira também

Funções de fonte e texto

Visão geral de fontes e texto

GetTextAlign

Selectobject

Setbkcolor

Settextalign

Settextcolor

TabbedTextOut