GetSystemPaletteUse  2L2N_RI 

The GetSystemPaletteUse function retrieves the current state of the system (physical) palette for the specified device context.

UINT GetSystemPaletteUse(

    HDC hdc

// handle of device context

   );

 

 

Parameters

hdc

Identifies the device context.

 

Return Values

If the function succeeds, the return value is the current state of the system palette. It can be any of the following values:

Value

Meaning

SYSPAL_NOSTATIC

The system palette contains no static colors except black and white.

SYSPAL_STATIC

The system palette contains static colors that will not change when an application realizes its logical palette.

SYSPAL_ERROR

The given device context is invalid or does not support a color palette.

 

To get extended error information, call GetLastError11C2VS7.

Remarks

By default, the system palette contains 20 static colors that are not changed when an application realizes its logical palette. An application can gain access to most of these colors by calling the SetSystemPaletteUseCE31HF function.

The device context identified by the hdc parameter must represent a device that supports color palettes.

An application can determine whether or not a device supports color palettes by calling the GetDeviceCaps function and specifying the RASTERCAPS constant.

See Also

GetDeviceCaps, SetSystemPaletteUse