TreeView_SetImageList 宏 (commctrl.h)

设置树视图控件的正常或状态图像列表,并使用新图像重新绘制控件。 可以使用此宏或显式发送 TVM_SETIMAGELIST 消息。

语法

HIMAGELIST TreeView_SetImageList(
   HWND       hwnd,
   HIMAGELIST himl,
   INT        iImage
);

参数

hwnd

类型:HWND

树视图控件的句柄。

himl

类型:HIMAGELIST

图像列表的 HIMAGELIST 句柄。 如果 himlNULL,则消息将从树视图控件中删除指定的图像列表。

iImage

类型:INT

要设置的图像列表的类型。 此参数可以是以下值之一:

价值 意义
TVSIL_NORMAL
指示普通图像列表,其中包含树视图控件项的选定、未选择和覆盖图像。
TVSIL_STATE
指示状态映像列表。 可以使用状态图像来指示应用程序定义的项状态。 状态图像显示在项的选定或未选择图像的左侧。

返回值

类型:HIMAGELIST

返回上一个图像列表的 HIMAGELIST 句柄(如果有)或 NULL 否则。

言论

树视图控件不会销毁使用此消息指定的图像列表。 当不再需要映像列表时,应用程序必须销毁该列表。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 commctrl.h

另请参阅

参考

TVM_GETIMAGELIST

TreeView_GetImageList