Função RealizePalette (wingdi.h)
A função RealizePalette mapeia entradas de paleta da paleta lógica atual para a paleta do sistema.
Sintaxe
UINT RealizePalette(
[in] HDC hdc
);
Parâmetros
[in] hdc
Um identificador para o contexto do dispositivo no qual uma paleta lógica foi selecionada.
Valor retornado
Se a função for bem-sucedida, o valor retornado será o número de entradas na paleta lógica mapeada para a paleta do sistema.
Se a função falhar, o valor retornado será GDI_ERROR.
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.
A função RealizePalette modifica a paleta do dispositivo associado ao contexto de dispositivo especificado. Se o contexto do dispositivo for um DC de memória, a tabela de cores do bitmap selecionado no DC será modificada. Se o contexto do dispositivo for um DC de exibição, a paleta física desse dispositivo será modificada.
Uma paleta lógica é um buffer entre aplicativos com uso intensivo de cores e o sistema, permitindo que esses aplicativos usem quantas cores forem necessárias sem interferir nas cores exibidas por outras janelas.
Quando a janela de um aplicativo tem o foco e chama a função RealizePalette , o sistema tenta perceber o máximo possível de cores solicitadas. O mesmo também é verdadeiro para aplicativos com janelas inativas.
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 |