Metodo IImageList::ImageListSetStrip (mmc.h)

Articolo
03/08/2023

Il metodo IImageList::ImageListSetStrip consente a un utente di aggiungere una striscia di icone all'elenco di immagini usando una coppia di bitmap (icone grandi e piccole), a partire da una posizione identificata da nStartLoc.

Sintassi

HRESULT ImageListSetStrip(
  [in] LONG_PTR *pBMapSm,
  [in] LONG_PTR *pBMapLg,
  [in] long     nStartLoc,
  [in] COLORREF cMask
);

Parametri

[in] pBMapSm

Handle HBITMAP win32 per la piccola icona (16x16). Lo snap-in possiede questa risorsa e deve liberarlo al termine. Si verificherà una perdita di memoria delle risorse se lo snap-in non libera BMapSm.

[in] pBMapLg

Handle HBITMAP win32 per la striscia di immagini dell'icona di grandi dimensioni (32x32). Lo snap-in possiede questa risorsa e deve liberarlo al termine. Se lo snap-in non libera BMapLg, si verificherà una perdita di memoria delle risorse.

[in] nStartLoc

Valore che specifica l'indice assegnato alla prima immagine nella striscia. Si tratta di un indice virtuale mappato internamente all'indice effettivo.

[in] cMask

Valore che specifica il colore utilizzato per generare una maschera.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

Sia le bitmap piccole che grandi devono essere fornite e il numero di icone in ogni strip deve essere uguale. La bitmap piccola deve essere alta 16 pixel e 16n pixel wide, dove n è un valore intero. La bitmap di grandi dimensioni deve essere alta 32 pixel e 32n pixel wide.

Ogni pixel del colore usato per generare una maschera nella bitmap specificata viene modificata in nero e il bit corrispondente nella maschera è impostato su uno.

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	mmc.h
DLL	Mmcndmgr.dll

Vedi anche

IImageList

Condividi tramite