Skip to content

Latest commit

 

History

History
108 lines (83 loc) · 3.18 KB

nf-wingdi-getsystempaletteuse.md

File metadata and controls

108 lines (83 loc) · 3.18 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:wingdi.GetSystemPaletteUse
GetSystemPaletteUse function (wingdi.h)
The GetSystemPaletteUse function retrieves the current state of the system (physical) palette for the specified device context (DC).
GetSystemPaletteUse
GetSystemPaletteUse function [Windows GDI]
_win32_GetSystemPaletteUse
gdi.getsystempaletteuse
wingdi/GetSystemPaletteUse
gdi\getsystempaletteuse.htm
gdi
0a9e7906-2f81-4fda-b03d-86feb0755327
12/05/2018
GetSystemPaletteUse, GetSystemPaletteUse function [Windows GDI], _win32_GetSystemPaletteUse, gdi.getsystempaletteuse, wingdi/GetSystemPaletteUse
wingdi.h
Windows.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Gdi32.lib
Gdi32.dll
Windows
19H1
GetSystemPaletteUse
wingdi/GetSystemPaletteUse
c++
APIRef
kbSyntax
DllExport
gdi32.dll
Ext-MS-Win-GDI-Internal-Desktop-L1-1-0.dll
GDI32Full.dll
GetSystemPaletteUse

GetSystemPaletteUse function

-description

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

-parameters

-param hdc [in]

A handle to the device context.

-returns

If the function succeeds, the return value is the current state of the system palette. This parameter can be one 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.

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

-see-also

Color Functions

Colors Overview

GetDeviceCaps

SetSystemPaletteUse