CImageList::SetOverlayImage

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

更新 : 2007 年 11 月

オーバーレイマスクとして使うために、イメージの 0 から始まるインデックスをイメージのリストに追加します。

BOOL SetOverlayImage(
   int nImage,
   int nOverlay 
);

パラメータ

nImage
オーバーレイマスクとして使うイメージの 0 から始まるインデックス。
nOverlay
オーバーレイマスクの 1 から始まるインデックス。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

インデックスは 4 つまでリストに追加できます。

オーバーレイマスクは、ほかのイメージの上に透過的に描画されるイメージです。1 から始まるオーバーレイマスクのインデックスを使って CImageList::Draw メンバ関数を呼び出し、イメージの上にオーバーレイマスクを描画します。オーバーレイマスクの指定には、INDEXTOOVERLAYMASK マクロを使用します。

使用例

// Add a new image to the image list.
int nIndex = m_myImageList.Add(AfxGetApp()->LoadStandardIcon(IDI_QUESTION));

if (nIndex != -1)
{
   // Make the new image an overlay image.
   m_myImageList.SetOverlayImage(nIndex, 1);

   // Draw the first image in the image list with an overlay image.
   m_myImageList.Draw(&dc, 0, CPoint(0, 0), INDEXTOOVERLAYMASK(1));
}