GetSystemPaletteEntries 函式 (wingdi.h)

發行項
03/13/2024

GetSystemPaletteEntries 函式會從系統調色盤擷取與指定裝置內容相關聯的調色盤專案範圍， (DC) 。

語法

UINT GetSystemPaletteEntries(
  [in]  HDC            hdc,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

參數

[in] hdc

裝置內容的句柄。

[in] iStart

要從系統調色盤擷取的第一個專案。

[in] cEntries

要從系統調色盤擷取的項目數。

[out] pPalEntries

要接收調色盤專案的 PALETTEENTRY 結構陣列指標。陣列必須至少包含 cEntries 參數所指定的結構數目。如果此參數為 NULL，函式會傳回調色盤中的項目總數。

傳回值

如果函式成功，傳回值就是從調色盤擷取的項目數。

如果此函式失敗，則傳回值為零。

備註

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll