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

イメージ リスト内のイメージを新しいイメージに置き換えます。

構文

HRESULT Replace(
  [in]           int     i,
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask
);

パラメーター

[in] i

型: int

置換するイメージのインデックスを含む int 型の値。

[in] hbmImage

種類: HBITMAP

イメージを含むビットマップへのハンドル。

[in, optional] hbmMask

種類: HBITMAP

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

戻り値

種類: HRESULT

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

注釈

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

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

要件