IImageList::Add メソッド (commoncontrols.h)

  • [アーティクル]

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

構文

HRESULT Add(
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask,
  [out]          int     *pi
);

パラメーター

[in] hbmImage

種類: HBITMAP

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

[in, optional] hbmMask

種類: HBITMAP

マスクを含むビットマップのハンドル。 イメージ リストでマスクが使用されていない場合、このパラメーターは無視されます。

[out] pi

型: int*

このメソッドから制御が戻るときに、最初の新しいイメージのインデックスへのポインターが格納されます。 メソッドが新しいイメージを正常に追加できない場合、この値は -1 です。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

IImageList::Add は 、ビットマップを内部データ構造にコピーします。 DeleteObject 関数を使用して、メソッドが戻った後に hbmImage と hbmMask を削除する必要があります。

IImageList::Add を使用するには、マニフェスト Comctl32.dll バージョン 6 を指定します。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー commoncontrols.h
[DLL] Comctl32.dll (バージョン 6.0 以降)