animatePalette 函式 (wingdi.h)

發行項
03/04/2024

AnimatePalette 函式會取代指定之邏輯調色盤中的專案。

語法

BOOL AnimatePalette(
  [in] HPALETTE           hPal,
  [in] UINT               iStartIndex,
  [in] UINT               cEntries,
  [in] const PALETTEENTRY *ppe
);

參數

[in] hPal

邏輯調色盤的句柄。

[in] iStartIndex

要取代的第一個邏輯選擇區專案。

[in] cEntries

要取代的項目數。

[in] ppe

PALETTEENTRY 結構陣列中第一個成員的指標，用來取代目前的專案。

傳回值

如果函式成功，則傳回非零的值。

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

備註

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

AnimatePalette 函式只會變更 LOGPALETTE 結構對應 palPalEntry 成員中所設定PC_RESERVED旗標的專案。

如果指定的調色盤與活動窗口相關聯，則會立即取代調色盤中的色彩。

規格需求

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