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

Статья
03/05/2024

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

Синтаксис

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

Параметры

[in] iImageList

Тип: int

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

SHIL_LARGE (0x0)

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

SHIL_SMALL (0x1)

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

SHIL_EXTRALARGE (0x2)

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

SHIL_SYSSMALL (0x3)

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

SHIL_JUMBO (0x4)

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

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. Чтобы задать для этих типов разрешение на дюйм, вызовите SetProcessDPIAware. SHIL_JUMBO фиксируется на уровне 256 пикселей независимо от параметра с поддержкой dpi.

Требования

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

См. также раздел

FileIconInit

Поделиться через