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

Vedi anche

Funzioni colore

Panoramica dei colori

GetDeviceCaps

RealizePalette