STM_SETIMAGE消息

应用程序发送 STM_SETIMAGE 消息,以将新图像与静态控件相关联。

参数

wParam

指定要与静态控件关联的图像的类型。 此参数可能是以下值之一:

含义
IMAGE_BITMAP
位图。
IMAGE_CURSOR
光标。
IMAGE_ENHMETAFILE
增强型图元文件。
IMAGE_ICON
图标。

lParam

要与静态控件关联的图像的句柄。

返回值

返回值是以前与静态控件关联的图像的句柄(如果有);否则为 NULL

备注

若要将图像与静态控件相关联,该控件必须具有适当的样式。 下表显示了每种图像类型所需的样式。

映像类型 静态控件样式
IMAGE_BITMAP SS_BITMAP
IMAGE_CURSOR SS_ICON
IMAGE_ENHMETAFILE SS_ENHMETAFILE
IMAGE_ICON SS_ICON

重要

在版本 6 的 Microsoft Win32 控件中,使用 STM_SETIMAGE 消息传递给静态控件的位图与后续 STM_SETIMAGE 消息返回的位图相同。 客户端负责删除发送到静态控件的任何位图。

对于 Windows XP,如果 传入STM_SETIMAGE 消息中的位图包含非零 alpha 像素,则静态控件将获取位图的副本。 此复制的位图由下一 个STM_SETIMAGE 消息返回。 客户端代码可以独立跟踪传递给静态控件的位图,但如果它不检查并释放从STM_SETIMAGE消息返回的位图,则位图会泄漏。

要求

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

请参阅

STM_GETIMAGE