Funzione SelectPalette (wingdi.h)
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 |