Metodo IImageList::AddMasked (commoncontrols.h)

Articolo
02/24/2024

Aggiunge un'immagine o immagini a un elenco di immagini, generando una maschera dalla bitmap specificata.

Sintassi

HRESULT AddMasked(
  [in]  HBITMAP  hbmImage,
  [in]  COLORREF crMask,
  [out] int      *pi
);

Parametri

[in] hbmImage

Tipo: HBITMAP

Handle alla bitmap contenente una o più immagini. Il numero di immagini viene dedotto dalla larghezza della bitmap.

[in] crMask

Tipo: COLORREF

Colore utilizzato per generare la maschera. Ogni pixel di questo colore nella bitmap specificata viene modificato in nero e il bit corrispondente nella maschera è impostato su 1. Se questo parametro è CLR_DEFAULT, il colore del pixel in corrispondenza (0,0) viene usato come maschera.

[out] pi

Tipo: int*

Puntatore a un int che contiene l'indice della prima nuova immagine quando restituisce, se ha esito positivo o -1 in caso contrario.

Valore restituito

Tipo: HRESULT

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

Commenti

Nota La bitmap passata in hbmImage verrà modificata.

IImageList::AddMasked copia la bitmap in una struttura dati interna. Le bitmap con profondità di colore maggiore di 8bpp non sono supportate. È necessario usare la funzione DeleteObject per eliminare hbmImage e crMask dopo che il metodo restituisce.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commoncontrols.h
DLL	Comctl32.dll (versione 6.0 o successiva)

Share via