Metodo IImageList::Merge (commoncontrols.h)

Crea una nuova immagine combinando due immagini esistenti. Questo metodo crea anche un nuovo elenco di immagini in cui archiviare l'immagine.

Sintassi

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

Parametri

[in] i1

Tipo: int

Valore di tipo int contenente l'indice della prima immagine esistente.

[in] punk2

Tipo: IUnknown*

Puntatore all'interfaccia IUnknown dell'elenco di immagini contenente la seconda immagine.

[in] i2

Tipo: int

Valore di tipo int contenente l'indice della seconda immagine esistente.

[in] dx

Tipo: int

Valore di tipo int contenente il componente x dell'offset della seconda immagine rispetto alla prima immagine.

[in] dy

Tipo: int

Valore di tipo int contenente il componente y dell'offset della seconda immagine rispetto alla prima immagine.

[out] riid

Tipo: REFIID

Id dell'interfaccia per il nuovo elenco di immagini.

[out] ppv

Tipo: PVOID*

Puntatore non elaborato all'interfaccia per il nuovo elenco di immagini.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La nuova immagine è costituita dalla seconda immagine disegnata in modo trasparente sul primo. La maschera per la nuova immagine viene ottenuta combinando le maschere delle due immagini esistenti con l'operatore OR bit per bit.

Per usare IImageList::Merge, specificare Comctl32.dll versione 6 nel manifesto. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.

Requisiti