Condividi tramite


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