Funzione GetSystemPaletteUse (wingdi.h)

La funzione GetSystemPaletteUse recupera lo stato corrente del riquadro di sistema (fisico) per il contesto di dispositivo (DC) specificato.

Sintassi

UINT GetSystemPaletteUse(
  [in] HDC hdc
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito corrisponde allo stato corrente del riquadro di sistema. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
SYSPAL_NOSTATIC	La tavolozza di sistema non contiene colori statici tranne il nero e il bianco.
SYSPAL_STATIC	La tavolozza di sistema contiene colori statici che non cambieranno quando un'applicazione realizza la tavolozza logica.
SYSPAL_ERROR	Il contesto di dispositivo specificato non è valido o non supporta una tavolozza dei colori.

Commenti

Per impostazione predefinita, la tavolozza di sistema contiene 20 colori statici che non vengono modificati quando un'applicazione realizza la tavolozza logica. Un'applicazione può accedere alla maggior parte di questi colori chiamando la funzione SetSystemPaletteUse .

Il contesto di dispositivo identificato dal parametro hdc deve rappresentare un dispositivo che supporta le tavolozze dei colori.

Un'applicazione può determinare se un dispositivo supporta le tavolozze dei colori chiamando la funzione GetDeviceCaps e specificando la costante RASTERCAPS.

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

Vedi anche

Funzioni colore

Panoramica dei colori

GetDeviceCaps

SetSystemPaletteUse