Funzione SelectPalette (wingdi.h)

Articolo
03/13/2024

La funzione SelectPalette seleziona la tavolozza logica specificata in un contesto di dispositivo.

Sintassi

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

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] hPal

Handle per la tavolozza logica da selezionare.

[in] bForceBkgd

Specifica se la tavolozza logica deve essere una tavolozza di sfondo. Se questo valore è TRUE, la funzione RealizePalette fa sì che la tavolozza logica venga mappata ai colori già presenti nella tavolozza fisica nel modo migliore possibile. Questa operazione viene sempre eseguita, anche se la finestra per la quale viene realizzata la tavolozza appartiene a un thread senza lo stato attivo.

Se questo valore è FALSE, RealizePalette fa sì che la tavolozza logica venga copiata nel riquadro dispositivi quando l'applicazione è in primo piano. Se il parametro hdc è un contesto di dispositivo di memoria, questo parametro viene ignorato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il riquadro logico precedente del contesto di dispositivo.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Un'applicazione può determinare se un dispositivo supporta le operazioni del riquadro chiamando la funzione GetDeviceCaps e specificando la costante RASTERCAPS.

Un'applicazione può selezionare una tavolozza logica in più contesti di dispositivo solo se i contesti di dispositivo sono compatibili. In caso contrario , SelectPalette ha esito negativo. Per creare un contesto di dispositivo compatibile con un altro contesto di dispositivo, chiamare CreateCompatibleDC con il primo contesto di dispositivo come parametro. Se viene selezionata una tavolozza logica in più contesti di dispositivo, le modifiche apportate alla tavolozza logica influiranno su tutti i contesti di dispositivo per i quali è selezionata.

Un'applicazione potrebbe chiamare la funzione SelectPalette con il parametro bForceBackground impostato su TRUE se le finestre figlio di una finestra di primo livello realizzano le proprie tavolozze. Tuttavia, solo la finestra figlio che deve rendersi conto della tavolozza deve impostare bForceBackground su TRUE; altre finestre figlio devono impostare questo valore su FALSE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll