CImageList::Add

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

1 つ以上のイメージ、またはアイコンをイメージリストに追加します。

int Add(
   CBitmap* pbmImage,
   CBitmap* pbmMask 
);
int Add(
   CBitmap* pbmImage,
   COLORREF crMask 
);
int Add(
   HICON hIcon 
);

パラメータ

pbmImage
イメージまたは複数のイメージを持つビットマップへのポインタ。イメージの数はビットマップの幅から計算します。
pbmMask
マスクを持つビットマップへのポインタ。イメージリストでマスクが使用されない場合、このパラメータは無視されます。
crMask
マスクを生成するために使う色。指定されたビットマップでこの色を持つ各ピクセルは黒色に変更され、マスク内の対応するビットは 1 に設定されます。
hIcon
新しいイメージのビットマップとマスクを持つアイコンのハンドル。

戻り値

正常終了した場合は、最初の新しいイメージの 0 から始まるインデックスを返します。それ以外の場合は -1 を返します。

使用例

// Add my icons.
m_myImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON1));
m_myImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON2));

// Add my bitmap, make all black pixels transparent.
CBitmap bm;
bm.LoadBitmap(IDB_BITMAP1);
m_myImageList.Add(&bm, RGB(0, 0, 0));