GetPaletteEntries 函式 (wingdi.h)

發行項
03/08/2023

GetPaletteEntries函式會從指定的邏輯選擇區擷取指定的調色盤專案範圍。

語法

UINT GetPaletteEntries(
  [in]  HPALETTE       hpal,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

參數

[in] hpal

邏輯調色盤的控制碼。

[in] iStart

要擷取之邏輯調色盤中的第一個專案。

[in] cEntries

要擷取之邏輯選擇區中的專案數目。

[out] pPalEntries

要接收調色盤專案的 PALETTEENTRY 結構陣列指標。陣列必須至少包含 nEntries 參數所指定的結構數目。

傳回值

如果函式成功且邏輯調色盤的控制碼是有效的指標， (不是 Null) ，則傳回值為從邏輯選擇區擷取的專案數。如果函式成功且邏輯調色盤的控制碼為 Null，則傳回值是指定調色盤中的專案數。

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

備註

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

如果 nEntries 參數指定的專案比調色盤中還多，則不會改變 PALETTEENTRY 結構的其餘成員。

規格需求


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