ImageList_AddMasked

指定されたビットマップからマスクを生成しながら、イメージリストに画像を追加する。(ImageList_AddMasked)

ImageList_AddMasked himl, hbmImage, crMask

himl : [intptr] 型: HIMAGELIST イメージリストへのハンドル。
hbmImage : [intptr] 型: HBITMAP 1 つ以上の画像を含むビットマップへのハンドル。画像の個数はビットマップの幅から推測される。
crMask : [int] 型: COLORREF マスクの生成に使用する色。指定されたビットマップのこの色の各ピクセルは黒に変更され、対応するマスクのビットが 1 に設定される。このパラメータが CLR_DEFAULT の場合、座標 (0,0) のピクセルの色がマスクとして使用される。

(プラグイン / モジュール : comctl32.dll)

解説

指定されたビットマップからマスクを生成しながら、イメージリストに画像を追加する。(ImageList_AddMasked)

[戻り値]
型: int 成功した場合は最初の新しい画像のインデックスを返し、それ以外は -1 を返す。

[備考]
ImageList_AddMasked 関数は、ビットマップを内部データ構造にコピーする。8bpp
を超える色深度のビットマップはサポートされない。関数が戻った後は、DeleteObject 関数を使って必ず hbmImage
を削除すること。

情報