Função SetBkColor (wingdi.h)

Artigo
08/27/2023

A função SetBkColor define a cor da tela de fundo atual para o valor de cor especificado ou para a cor física mais próxima se o dispositivo não puder representar o valor de cor especificado.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] color

A nova cor da tela de fundo. Para criar um valor COLORREF , use a macro RGB .

Valor retornado

Se a função for bem-sucedida, o valor retornado especificará a cor da tela de fundo anterior como um valor COLORREF .

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

Comentários

Essa função preenche as lacunas entre linhas estilizadas desenhadas usando uma caneta criada pela função CreatePen ; ele não preenche as lacunas entre linhas estilizadas desenhadas usando uma caneta criada pela função ExtCreatePen . A função SetBkColor também define as cores da tela de fundo para TextOut e ExtTextOut.

Se o modo de plano de fundo for OPACO, a cor da tela de fundo será usada para preencher lacunas entre linhas estilizadas, lacunas entre linhas eclodidas em pincéis e células de caracteres. A cor da tela de fundo também é usada ao converter bitmaps de cor em monocromático e vice-versa.

Exemplos

Para obter um exemplo, confira "Exemplo de itens de menu Owner-Drawn" em Usando menus.

Requisitos


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