Méthode IImageList::ImageListSetStrip (mmc.h)

Article
08/24/2023

La méthode IImageList::ImageListSetStrip permet à un utilisateur d’ajouter une bande d’icônes à la liste d’images à l’aide d’une paire de bitmaps (grandes et petites icônes), en commençant à un emplacement identifié par nStartLoc.

Syntaxe

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

Paramètres

[in] pBMapSm

Poignée Win32 HBITMAP à la petite bande d’image d’icône (16x16). Le composant logiciel enfichable possède cette ressource et doit la libérer une fois terminé. Une fuite de mémoire de ressource se produit si le composant logiciel enfichable ne libère pas BMapSm.

[in] pBMapLg

Poignée Win32 HBITMAP dans la grande bande d’image d’icône (32x32). Le composant logiciel enfichable possède cette ressource et doit la libérer une fois terminé. Une fuite de mémoire de ressource se produit si le composant logiciel enfichable ne libère pas BMapLg.

[in] nStartLoc

Valeur qui spécifie l’index affecté à la première image de la bande. Il s’agit d’un index virtuel qui est mappé en interne à l’index réel.

[in] cMask

Valeur qui spécifie la couleur utilisée pour générer un masque.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

Les bitmaps de petite et grande taille doivent être fournies et le nombre d’icônes dans chaque bande doit être égal. La petite bitmap doit avoir une hauteur de 16 pixels et une largeur de 16n pixels, où n est une valeur entière. La grande bitmap doit avoir une hauteur de 32 pixels et une largeur de 32n pixels.

Chaque pixel de la couleur utilisée pour générer un masque dans l’image bitmap spécifiée est remplacé par noir et le bit correspondant dans le masque est défini sur un.

Spécifications


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	mmc.h
DLL	Mmcndmgr.dll

Voir aussi

IImageList

Partager via