Función SHGetImageList (shellapi.h)
Recupera una lista de imágenes.
Sintaxis
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. El tamaño de la imagen suele ser 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 de icono pequeño estándar 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 de icono extra grande estándar 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 llamado con SM_CYSMICON.
SHIL_JUMBO (0x4)
0x4. Windows Vista y versiones posteriores. Normalmente, la imagen es de 256 x 256 píxeles.
SHIL_LAST
El valor de marca válido más grande, con fines de validación.
[in] riid
Tipo: REFIID
Referencia al identificador de la 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. Suele ser IImageList.
Valor devuelto
Tipo: HRESULT
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shellapi.h |
| Archivo DLL | Shell32.dll |
| Conjunto de API | ext-ms-win-shell-shell32-l1-2-2 (introducido en Windows 10, versión 10.0.14393) |