SHGetImageList, fonction (shellapi.h)
Récupère une liste d’images.
Syntaxe
SHSTDAPI SHGetImageList(
[in] int iImageList,
[in] REFIID riid,
[out] void **ppvObj
);
Paramètres
[in] iImageList
Type : int
Type d’image contenu dans la liste. Une des valeurs suivantes :
SHIL_LARGE (0x0)
0x0. La taille de l’image est normalement de 32 x 32 pixels. Toutefois, si l’option Utiliser de grandes icônes est sélectionnée dans la section Effets de l’onglet Apparence dans Propriétés d’affichage, l’image est de 48 x 48 pixels.
SHIL_SMALL (0x1)
0x1. Ces images sont la petite taille d’icône Shell standard de 16x16, mais la taille peut être personnalisée par l’utilisateur.
SHIL_EXTRALARGE (0x2)
0x2. Ces images sont la taille d’icône standard de Shell extra-volumineuse. Il s’agit généralement de 48x48, mais la taille peut être personnalisée par l’utilisateur.
SHIL_SYSSMALL (0x3)
0x3. Ces images sont la taille spécifiée par GetSystemMetrics appelée avec SM_CXSMICON et GetSystemMetrics appelées avec SM_CYSMICON.
SHIL_JUMBO (0x4)
0x4. Windows Vista et versions ultérieures. L’image est normalement de 256 x 256 pixels.
SHIL_LAST
Valeur d’indicateur valide la plus importante, à des fins de validation.
[in] riid
Type : REFIID
Référence à l’identificateur d’interface de liste d’images, normalement IID_IImageList.
[out] ppvObj
Type : void**
Lorsque cette méthode est retournée, contient le pointeur d’interface demandé dans riid. Il s’agit généralement d’IImageList.
Valeur retournée
Type : HRESULT
Si cette fonction réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .
Notes
Le type de pointeur IImageList , tel que celui retourné dans le paramètre ppv , peut être casté en tant que HIMAGELIST en fonction des besoins; par exemple, pour une utilisation dans un affichage de liste. À l’inverse, un HIMAGELIST peut être converti en pointeur vers un IImageList.
À compter de Windows Vista, SHIL_SMALL, SHIL_LARGE et SHIL_EXTRALARGE mise à l’échelle avec des points par pouce (dpi) si le processus est marqué comme étant conscient de l’ipi. Pour définir ces types comme prenant en charge les ppp, appelez SetProcessDPIAware. SHIL_JUMBO est fixe à 256 pixels, quel que soit le paramètre prenant en charge les ppp.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shellapi.h |
| DLL | Shell32.dll |
| Ensemble d’API | ext-ms-win-shell-shell32-l1-2-2 (introduit dans Windows 10, version 10.0.14393) |