BCM_SETIMAGELIST消息

将图像列表分配给按钮控件。 可以显式发送此消息或使用 Button_SetImageList 宏。

参数

wParam

未使用;必须为零。

lParam

指向包含图像列表信息的 BUTTON_IMAGELIST 结构的指针。

返回值

如果消息成功,则返回 TRUE。 否则返回 FALSE

注解

注意

若要使用此消息,必须提供一个清单,指定版本 6.0 Comclt32.dll。 有关清单的详细信息,请参阅 “启用视觉样式”。

BUTTON_IMAGELIST结构的 himl 成员中引用的图像列表应包含要用于所有状态的单个图像或每个状态的单个图像。 vssym32.h 中定义了以下状态。

enum PUSHBUTTONSTATES {
    PBS_NORMAL = 1,
    PBS_HOT = 2,
    PBS_PRESSED = 3,
    PBS_DISABLED = 4,
    PBS_DEFAULTED = 5,
    PBS_STYLUSHOT = 6,
};

请注意,PBS_STYLUSHOT仅在平板电脑上使用。

每个值都是图像列表中的相应图像的索引。 如果只有一个图像存在,则它用于所有状态。 如果图像列表包含多个图像,则每个索引对应于按钮的一个状态。 如果未为每个状态提供图像,则不为没有图像的状态绘制任何图像。

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
Commctrl.h