GetSystemPaletteUse

  UINT GetSystemPaletteUse(hdc)    
  HDC hdc; /* handle of device context */

The GetSystemPaletteUse function retrieves the current state of the physical palette for the given device context.

Parameters

hdc

Identifies the device context.

Return Value

The return value specifies the current state of the physical palette if the function is successful. 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 which 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.

Comments

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

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

See Also

SetSystemPaletteUse