animatePalette 函数 (wingdi.h)

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)
Library	Gdi32.lib
DLL	Gdi32.dll

另请参阅

颜色函数

颜色概述

CreatePalette

GetDeviceCaps

LOGPALETTE

PALETTEENTRY