Función SHGetImageList (shellapi.h)

Recupera una lista de imágenes.

Syntax

SHSTDAPI SHGetImageList(
  [in]  int    iImageList,
  [in]  REFIID riid,
  [out] void   **ppvObj
);

Parámetros

[in] iImageList

Tipo: int

Tipo de imagen contenido en la lista. Uno de los siguientes valores:

SHIL_LARGE (0x0)

0x0. Normalmente, el tamaño de la imagen es de 32 x 32 píxeles. Sin embargo, si la opción Usar iconos grandes está seleccionada en la sección Efectos de la pestaña Apariencia en Propiedades de presentación, la imagen es de 48 x 48 píxeles.

SHIL_SMALL (0x1)

0x1. Estas imágenes son el tamaño estándar de icono pequeño de Shell de 16 x 16, pero el usuario puede personalizar el tamaño.

SHIL_EXTRALARGE (0x2)

0x2. Estas imágenes son el tamaño estándar de icono adicional grande de Shell. Normalmente es de 48 x 48, pero el usuario puede personalizar el tamaño.

SHIL_SYSSMALL (0x3)

0x3. Estas imágenes son el tamaño especificado por GetSystemMetrics llamado con SM_CXSMICON y GetSystemMetrics llamados con SM_CYSMICON.

SHIL_JUMBO (0x4)

0x4. Windows Vista y versiones posteriores. Normalmente, la imagen es de 256 x 256 píxeles.

SHIL_LAST

Valor de marca válido más grande, con fines de validación.

[in] riid

Tipo: REFIID

Referencia al identificador de interfaz de lista de imágenes, normalmente IID_IImageList.

[out] ppvObj

Tipo: void**

Cuando este método vuelve, contiene el puntero de interfaz solicitado en riid. Esto suele ser IImageList.

Valor devuelto

Tipo: HRESULT

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Observaciones

El tipo de puntero IImageList , como el devuelto en el parámetro ppv , se puede convertir como HIMAGELIST según sea necesario; por ejemplo, para su uso en una vista de lista. Por el contrario, un HIMAGELIST se puede convertir como puntero a un IImageList.

A partir de Windows Vista, SHIL_SMALL, SHIL_LARGE y SHIL_EXTRALARGE escala con puntos por pulgada (ppp) si el proceso está marcado como compatible con ppp. Para establecer estos tipos para que sean compatibles con ppp, llame a SetProcessDPIAware. SHIL_JUMBO se fija en 256 píxeles, independientemente de la configuración compatible con ppp.

Requisitos

Consulte también

FileIconInit