Функция SHGetImageList (shellapi.h)

Извлекает список изображений.

Синтаксис

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

Параметры

[in] iImageList

Тип: int

Тип изображения, содержащийся в списке. Одно из следующих значений:

SHIL_LARGE (0x0)

0x0. Размер изображения обычно составляет 32x32 пикселя. Однако если выбран параметр "Использовать большие значки " в разделе "Эффекты " вкладки "Внешний вид " в свойствах отображения, изображение равно 48 x 48 пикселей.

SHIL_SMALL (0x1)

0x1. Эти изображения являются стандартным маленьким значком оболочки размером 16x16, но размер может быть настроен пользователем.

SHIL_EXTRALARGE (0x2)

0x2. Эти изображения представляют собой стандартный размер значка оболочки с дополнительными размерами. Обычно это 48x48, но размер может быть настроен пользователем.

SHIL_SYSSMALL (0x3)

0x3. Эти изображения представляют собой размер, указанный методом GetSystemMetrics , который вызывается с помощью SM_CXSMICON и GetSystemMetrics с SM_CYSMICON.

SHIL_JUMBO (0x4)

0x4. Windows Vista и более поздние версии. Изображение обычно составляет 256x256 пикселей.

SHIL_LAST

Наибольшее допустимое значение флага для целей проверки.

[in] riid

Тип: REFIID

Ссылка на идентификатор интерфейса списка изображений, обычно IID_IImageList.

[out] ppvObj

Тип: void**

Когда этот метод возвращается, содержит указатель интерфейса, запрошенный в riid. Обычно это IImageList.

Возвращаемое значение

Тип: HRESULT

Если эта функция выполнена успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Замечания

Тип указателя IImageList , например возвращаемый в параметре PPV , можно при необходимости привести в качестве объекта HIMAGELIST ; например, для использования в представлении списка. И наоборот, МЕТОД HIMAGELIST можно привести в качестве указателя на IImageList.

По состоянию на Windows Vista , SHIL_SMALL, SHIL_LARGE и SHIL_EXTRALARGE масштабировать с точками на дюйм (dpi), если процесс помечен как dpi-aware. Чтобы задать эти типы для поддержки dpi, вызовите SetProcessDPIAware. SHIL_JUMBO исправлено на 256 пикселей независимо от параметра с поддержкой dpi.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
Header	shellapi.h
Library	OneCore.Lib
DLL	Shell32.dll
Набор API	ext-ms-win-shell-shell32-l1-2-2 (представлено в Windows 10 версии 10.0.14393)

См. также

FileIconInit