CImageList::Create

初始化图像列表并将它附加到 CImageList选件类 对象。

BOOL Create(
   int cx,
   int cy,
   UINT nFlags,
   int nInitial,
   int nGrow 
);
BOOL Create(
   UINT nBitmapID,
   int cx,
   int nGrow,
   COLORREF crMask 
);
BOOL Create(
   LPCTSTR lpszBitmapID,
   int cx,
   int nGrow,
   COLORREF crMask 
);
BOOL Create(
   CImageList& imagelist1,
   int nImage1,
   CImageList& imagelist2,
   int nImage2,
   int dx,
   int dy 
);
BOOL Create(
   CImageList* pImageList 
);

参数

  • cx
    维度每个图像,以像素为单位。

  • cy
    维度每个图像,以像素为单位。

  • nFlags
    指定图像列表的类型创建。此参数可以是下列值的组合,但是,它只能包含一 ILC_COLOR 值。

    含义

    ILC_COLOR

    不要使用默认行为,如果另一 ILC_COLOR*标志指定。通常,默认值为; ILC_COLOR4但是,对于较旧的显示驱动程序,默认值为 ILC_COLORDDB。

    ILC_COLOR4

    使用4位(16色)设备无关位图(DIB)部分,图像的位图列表。

    ILC_COLOR8

    使用8位DIB部分。用于颜色表的颜色为color和半音调色板相同。

    ILC_COLOR16

    使用16位(32/64k颜色) DIB部分。

    ILC_COLOR24

    使用24位DIB部分。

    ILC_COLOR32

    使用32位DIB部分。

    ILC_COLORDDB

    使用与设备相关的位图。

    ILC_MASK

    使用掩码。图像列表包含两个位图,其中是蒙板的单色位图。如果此值不包括在内,该图像仅列出包含一个位图。请参见 从图像的绘制图像列表 有关掩码图像的更多信息。

  • nInitial
    该图像最初列表图像的数字包含。

  • nGrow
    图像列表图像的数字可根据该系统需要调整列表腾出空间。新图像。此参数表示已调整大小的图像列表可以包含新图像的数目。

  • nBitmapID
    将关联的位图的资源ID与图像列表。

  • crMask
    使用的颜色生成掩码。此颜色每像素在指定的位图的已更改为黑色,因此,在掩码中对应的位设置为一个。

  • lpszBitmapID
    包含图像的资源ID的字符串。

  • imagelist1
    CImageList 对象的引用。

  • nImage1
    第一个现有图像的索引。

  • imagelist2
    CImageList 对象的引用。

  • nImage2
    第二个现有图像的索引。

  • dx
    第二个图像的X轴的偏移量。关系于第一个图形,以像素为单位。

  • dy
    第二个图像的y轴的偏移量。关系于第一个图形,以像素为单位。

  • pImageList
    CImageList 对象的指针。

返回值

非零,如果成功;否则为0。

备注

在构造在两个步骤的 CImageList。首先,调用构造函数然后调用 Create,生成图像列表并将它附加到 CImageList对象。

示例

m_myImageList.Create(32, 32, ILC_COLOR8, 0, 4);

要求

标头: afxcmn.h

请参见

参考

CImageList选件类

层次结构图

CImageList::CImageList

COLORREF

从图像的绘制图像列表