BCM_SETIMAGELIST消息

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

参数

wParam

未使用;必须为零。

lParam

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

返回值

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

备注

注意

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

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