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 |