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 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 taille d’icône Standard Shell de 16 x 16, mais la taille peut être personnalisée par l’utilisateur.

SHIL_EXTRALARGE (0x2)

0x2. Ces images sont la taille d’icône Standard Shell extra-large. 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 avecSM_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, 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 en fonction des besoins ; par exemple, pour une utilisation dans un affichage de liste. À l’inverse, un HIMAGELIST peut être casté en tant que pointeur vers un IImageList.

À compter 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 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.

Spécifications

Voir aussi

FileIconInit