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