Compartilhar via


Função SetBkColor (wingdi.h)

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

Confira também

COLORREF

Createpen

ExtCreatePen

Getbkcolor

GetBkMode

Funções de pintura e desenho

Visão geral de pintura e desenho

Setbkmode