Função SetTextColor (wingdi.h)

Artigo
03/13/2024

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