Função SelectPalette (wingdi.h)

A função SelectPalette seleciona a paleta lógica especificada em um contexto de dispositivo.

Sintaxe

HPALETTE SelectPalette(
  [in] HDC      hdc,
  [in] HPALETTE hPal,
  [in] BOOL     bForceBkgd
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] hPal

Um identificador para a paleta lógica a ser selecionada.

[in] bForceBkgd

Especifica se a paleta lógica é forçada a ser uma paleta de planos de fundo. Se esse valor for TRUE, a função RealizePalette fará com que a paleta lógica seja mapeada para as cores que já estão na paleta física da melhor maneira possível. Isso é sempre feito, mesmo que a janela para a qual a paleta seja realizada pertença a um thread sem foco ativo.

Se esse valor for FALSE, RealizePalette fará com que a paleta lógica seja copiada para a paleta de dispositivos quando o aplicativo estiver em primeiro plano. (Se o parâmetro hdc for um contexto de dispositivo de memória, esse parâmetro será ignorado.)

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para a paleta lógica anterior do contexto do dispositivo.

Se a função falhar, o valor retornado será NULL.

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.

Um aplicativo pode selecionar uma paleta lógica em mais de um contexto de dispositivo somente se os contextos do dispositivo forem compatíveis. Caso contrário , SelectPalette falhará. Para criar um contexto de dispositivo compatível com outro contexto de dispositivo, chame CreateCompatibleDC com o primeiro contexto de dispositivo como o parâmetro . Se uma paleta lógica for selecionada em mais de um contexto de dispositivo, as alterações na paleta lógica afetarão todos os contextos do dispositivo para os quais ele está selecionado.

Um aplicativo pode chamar a função SelectPalette com o parâmetro bForceBackground definido como TRUE se as janelas filho de uma janela de nível superior perceberem suas próprias paletas. No entanto, somente a janela filho que precisa perceber sua paleta deve definir bForceBackground como TRUE; outras janelas filho devem definir esse valor como FALSE.

Requisitos

Confira também

Funções de cor

Visão geral de cores

Createcompatibledc

Createpalette

Getdevicecaps

Realizepalette