iImageList::ImageListSetStrip 方法 (mmc.h)

IImageList::ImageListSetStrip 方法使用户能够使用一对位图 (大小图标) 向图像列表添加图标条,从 nStartLoc 标识的位置开始。

语法

HRESULT ImageListSetStrip(
  [in] LONG_PTR *pBMapSm,
  [in] LONG_PTR *pBMapLg,
  [in] long     nStartLoc,
  [in] COLORREF cMask
);

parameters

[in] pBMapSm

小 (16x16) 图标图像条的 Win32 HBITMAP 句柄。 管理单元拥有此资源,并且必须在完成后将其释放。 如果管理单元未释放 BMapSm,则会发生资源内存泄漏。

[in] pBMapLg

大 (32x32) 图标图像条的 Win32 HBITMAP 句柄。 管理单元拥有此资源,并且必须在完成后将其释放。 如果管理单元未释放 BMapLg,则会发生资源内存泄漏。

[in] nStartLoc

一个 值,该值指定分配给条带中的第一个图像的索引。 这是在内部映射到实际索引的虚拟索引。

[in] cMask

一个 值,该值指定用于生成掩码的颜色。

返回值

此方法可以返回其中一个值。

注解

必须同时提供小位图和大位图,并且每个条带中的图标数必须相等。 小位图必须高 16 像素,宽 16n 像素,其中 n 是整数值。大位图必须高 32 像素,宽 32n 像素。

用于在指定位图中生成掩码的颜色的每个像素都更改为黑色,掩码中的相应位设置为 1。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 mmc.h
DLL Mmcndmgr.dll

另请参阅

IImageList