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

既存の 2 つのイメージを組み合わせて、新しいイメージを作成します。 このメソッドは、イメージを格納する新しいイメージ リストも作成します。

構文

HRESULT Merge(
  [in]  int      i1,
  [in]  IUnknown *punk2,
  [in]  int      i2,
  [in]  int      dx,
  [in]  int      dy,
  [out] REFIID   riid,
  [out] void     **ppv
);

パラメーター

[in] i1

型: int

最初の既存のイメージのインデックスを含む int 型の値。

[in] punk2

種類: IUnknown*

2 番目のイメージを含むイメージ リストの IUnknown インターフェイスへのポインター。

[in] i2

型: int

2 番目の既存のイメージのインデックスを含む int 型の値。

[in] dx

型: int

最初のイメージに対する 2 番目のイメージのオフセットの x 成分を含む int 型の値。

[in] dy

型: int

最初のイメージに対する 2 番目のイメージのオフセットの y 成分を含む int 型の値。

[out] riid

型: REFIID

新しいイメージ リストのインターフェイスの IID。

[out] ppv

種類: PVOID*

新しいイメージ リストのインターフェイスへの生ポインター。

戻り値

型: HRESULT

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

注釈

新しいイメージは、1 つ目の上に透明に描画された 2 番目のイメージで構成されます。 新しいイメージのマスクは、2 つの既存のイメージのマスクとビットごとの OR 演算子を組み合わせることによって取得されます。

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

要件

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