ImageList_Add

イメージリストにイメージを追加します。

int ImageList_Add(
    HIMAGELIST himl,     // イメージリストのハンドル
    HBITBAP    hbmImage, // イメージのビットマップハンドル
    HBITMAP    hbmMask   // マスクのビットマップハンドル
);

COMCTL32.DLL

引数

himl

イメージリストのハンドルを指定します。

hbmImage

イメージリストに追加するイメージのビットマップのハンドルを指定します。追加されるイメージの数は、ビットマップの幅から計算されます。

hbmMask

イメージリストに追加するイメージのマスクとして使用するビットマップのハンドルを指定します。イメージリストにマスクを使用しない場合は、この引数は無視されます。

戻り値

成功すると、追加されたイメージの中で最初のイメージのインデックスが返ります。

失敗すると -1 が返ります。

解説

この関数は hbmImage パラメータおよび hbmMask パラメータのビットマップを内部のデータ構造体にコピーします。これらのビットマップを他に必要としないならば、この関数の呼び出し後に DeleteObject 関数によって削除しなければなりません。

対応情報

Windows 95 以降 / Windows NT 3.51 以降