Função UpdateColors (wingdi.h)
A função UpdateColors atualiza a área do cliente do contexto do dispositivo especificado remapeando as cores atuais na área do cliente para a paleta lógica atualmente realizada.
Sintaxe
BOOL UpdateColors(
[in] HDC hdc
);
Parâmetros
[in] hdc
Um identificador para o contexto do dispositivo.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero.
Comentários
Um aplicativo pode determinar se um dispositivo dá suporte a operações de paleta chamando a função GetDeviceCaps e especificando a constante RASTERCAPS.
Uma janela inativa com uma paleta lógica realizada pode chamar UpdateColors como uma alternativa para redesenhar sua área de cliente quando a paleta do sistema for alterada.
A função UpdateColors normalmente atualiza uma área do cliente mais rapidamente do que redesenhar a área. No entanto, como UpdateColors executa a tradução de cores com base na cor de cada pixel antes da paleta do sistema ser alterada, cada chamada para essa função resulta na perda de alguma precisão de cor.
Essa função deve ser chamada logo após o recebimento de uma mensagem de WM_PALETTECHANGED .
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 |