ImageList_AddMasked 関数 (commctrl.h)

イメージまたはイメージをイメージ リストに追加し、指定したビットマップからマスクを生成します。

構文

int ImageList_AddMasked(
  HIMAGELIST himl,
  HBITMAP    hbmImage,
  COLORREF   crMask
);

パラメーター

himl

種類: HIMAGELIST

イメージ リストへのハンドル。

hbmImage

種類: HBITMAP

1 つ以上のイメージを含むビットマップのハンドル。 イメージの数は、ビットマップの幅から推論されます。

crMask

種類: COLORREF

マスクの生成に使用される色。 指定したビットマップ内のこの色の各ピクセルが黒に変更され、マスク内の対応するビットが 1 に設定されます。 このパラメーターがCLR_DEFAULTの場合は、(0,0) のピクセルの色がマスクとして使用されます。

戻り値

型: int

成功した場合は最初の新しいイメージのインデックスを返し、それ以外の場合は -1 を返します。

解説

ImageList_AddMasked関数は、ビットマップを内部データ構造にコピーします。 色深度が 8bpp を超えるビットマップはサポートされていません。 DeleteObject 関数を使用して、関数が戻った後に hbmImage を削除してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commctrl.h
Library Comctl32.lib
[DLL] Comctl32.dll
API セット ext-ms-win-shell-comctl32-init-l1-1-1 (Windows 10 バージョン 10.0.14393 で導入)