Compartilhar via


Função SetTextColor (wingdi.h)

A função SetTextColor define a cor do texto do contexto do dispositivo especificado como a cor especificada.

Sintaxe

COLORREF SetTextColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] color

A cor do texto.

Retornar valor

Se a função for bem-sucedida, o valor retornado será uma referência de cor para a cor do texto anterior como um valor COLORREF .

Se a função falhar, o valor de retorno será CLR_INVALID.

Comentários

A cor do texto é usada para desenhar a face de cada caractere escrito pelas funções TextOut e ExtTextOut . A cor do texto também é usada na conversão de bitmaps de cor para monocromática e vice-versa.

Exemplos

Para obter um exemplo, confira "Configurando fontes para Menu-Item cadeias de caracteres de texto" em Usando menus.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

Bitblt

COLORREF

Exttextout

Funções de fonte e texto

Visão geral de fontes e texto

GetTextColor

RGB

Setbkcolor

Stretchblt

Textout