Funzione UpdateColors (wingdi.h)
La funzione UpdateColors aggiorna l'area client del contesto di dispositivo specificato eseguendo il mapping dei colori correnti nell'area client alla tavolozza logica attualmente realizzata.
Sintassi
BOOL UpdateColors(
[in] HDC hdc
);
Parametri
[in] hdc
Handle per il contesto del dispositivo.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero.
Commenti
Un'applicazione può determinare se un dispositivo supporta le operazioni del riquadro chiamando la funzione GetDeviceCaps e specificando la costante RASTERCAPS.
Una finestra inattiva con una tavolozza logica realizzata può chiamare UpdateColors come alternativa per ridisegnare l'area client quando cambia la tavolozza di sistema.
La funzione UpdateColors aggiorna in genere un'area client più velocemente rispetto a quella di ridisegnare l'area. Tuttavia, poiché UpdateColors esegue la conversione dei colori in base al colore di ogni pixel prima della modifica della tavolozza di sistema, ogni chiamata a questa funzione comporta la perdita di un'accuratezza del colore.
Questa funzione deve essere chiamata subito dopo la ricezione di un messaggio di WM_PALETTECHANGED .
Requisiti
| 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 |