CImageList::Add

[アーティクル]
08/09/2011

更新 : 2010 年 6 月

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));