GetSystemPaletteUse 函式 (wingdi.h)

GetSystemPaletteUse 函式會針對指定的裝置內容 (DC) ，擷取系統 (實體) 調色盤的目前狀態。

語法

UINT GetSystemPaletteUse(
  [in] HDC hdc
);

[in] hdc

裝置內容的句柄。

如果函式成功，傳回值就是系統調色盤的目前狀態。此參數可以是下列其中一個值。

值	意義
SYSPAL_NOSTATIC	系統調色盤不含靜態色彩，但黑色和白色除外。
SYSPAL_STATIC	系統調色盤包含靜態色彩，當應用程式實現其邏輯調色盤時，將不會變更。
SYSPAL_ERROR	指定的裝置內容無效或不支援調色盤。

根據預設，系統調色盤包含 20 種靜態色彩，當應用程式實現其邏輯調色盤時不會變更。應用程式可以藉由呼叫 SetSystemPaletteUse 函式來存取大部分的色彩。

hdc 參數所識別的裝置內容必須代表支援調色盤的裝置。

應用程式可以呼叫 GetDeviceCaps 函式並指定 RASTERCAPS 常數，來判斷裝置是否支援調色盤。