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 [仅限桌面应用] |
标头 |
|