SHGetImageList, fonction (shellapi.h)

Article
08/26/2023

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 les 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 Standard Shell de 16x16, mais la taille peut être personnalisée par l’utilisateur.

SHIL_EXTRALARGE (0x2)

0x2. Ces images sont de la taille d’icône extra-large standard de Shell. Il s’agit généralement de 48 x 48, 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ée 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 grande, à 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 retourne, 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, elle retourne un code d’erreur HRESULT.

Remarques

Le type de pointeur IImageList , tel que celui retourné dans le paramètre ppv , peut être casté en tant que HIMAGELIST si nécessaire ; par exemple, pour une utilisation dans un affichage de liste. À l’inverse, un HIMAGELIST peut être casté en tant que pointeur vers un IImageList.

À partir de Windows Vista, SHIL_SMALL, SHIL_LARGE et SHIL_EXTRALARGE mise à l’échelle avec des points par pouce (ppp) si le processus est marqué comme prenant en charge les ppp. Pour définir ces types pour qu’ils soient compatibles avec les ppp, appelez SetProcessDPIAware. SHIL_JUMBO est fixe à 256 pixels, quel que soit le paramètre prenant en charge les ppp.

Configuration requise

Condition requise	Valeur
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)

Voir aussi

FileIconInit

Partager via