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

Confira também

Funções de cor

Visão geral de cores

Createpalette

Getdevicecaps

SelectPalette