Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

GetSystemPaletteUse function

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

Syntax


UINT GetSystemPaletteUse(
  _In_  HDC hdc
);

Parameters

hdc [in]

A handle to the device context.

Return value

If the function succeeds, the return value is the current state of the system palette. This parameter can be one of the following values.

ValueMeaning
SYSPAL_NOSTATICThe system palette contains no static colors except black and white.
SYSPAL_STATICThe system palette contains static colors that will not change when an application realizes its logical palette.
SYSPAL_ERRORThe given device context is invalid or does not support a color palette.

 

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 SetSystemPaletteUse function.

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

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

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Colors Overview
Color Functions
GetDeviceCaps
SetSystemPaletteUse

 

 

Community Additions

Show:
© 2014 Microsoft