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

Функция extractIconEx создает массив дескрипторов для больших или небольших значков, извлеченных из указанного исполняемого файла, DLL или файла значков.

Синтаксис

UINT ExtractIconExA(
  [in]  LPCSTR lpszFile,
  [in]  int    nIconIndex,
  [out] HICON  *phiconLarge,
  [out] HICON  *phiconSmall,
        UINT   nIcons
);

Параметры

[in] lpszFile

Тип: LPCTSTR

Указатель на строку, завершающуюся значением NULL, которая указывает имя исполняемого файла, dll или файла значка, из которого будут извлечены значки.

[in] nIconIndex

Тип: int

Указывает отсчитываемый от нуля индекс первого значка. Например, если это значение равно нулю, функция извлекает первый значок в указанном файле.

Если это значение равно –1 и phiconLarge и phiconSmallNULL, функция возвращает общее количество значков в указанном файле. Если файл является исполняемым файлом или библиотекой DLL, возвращаемое значение — это количество RT_GROUP_ICON ресурсов. Если файл является файлом .ico, возвращаемое значение равно 1.

Если это значение является отрицательным числом и phiconLarge или phiconSmall не NULL, функция начинается с извлечения значка, идентификатор ресурса которого равен абсолютному значению nIconIndex. Например, используйте -3 для извлечения значка, идентификатор ресурса которого равен 3.

[out] phiconLarge

Тип: HICON*

Указатель на массив дескрипторов значков, получающих дескриптор больших значков, извлеченных из файла. Если этот параметр null, большие значки не извлекаются из файла.

[out] phiconSmall

Тип: HICON*

Указатель на массив дескрипторов значков, получающих дескриптор небольших значков, извлеченных из файла. Если этот параметр null, из файла извлекаются не небольшие значки.

nIcons

Тип: UINT

Количество значков, извлеченных из файла.

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

Тип: UINT

Если параметр nIconIndex -1, а параметр phiconLarge и phiconSmallNULL, то возвращаемое значение — это количество значков, содержащихся в указанном файле.

Если параметр nIconIndex имеет любое значение, отличное от -1, и phiconLarge или phiconSmall не NULL, возвращаемое значение — это количество значков, успешно извлеченных из файла.

Замечания

Если они больше не нужны, необходимо уничтожить все значки, извлеченные ExtractIconEx путем вызова функции DestroyIcon.

Чтобы получить измерения больших и небольших значков, используйте эту функцию с флагами SM_CXICON, SM_CYICON, SM_CXSMICON и SM_CYSMICON.

Требования

См. также

ExtractAssociatedIcon

ExtractAssociatedIconEx

ExtractIcon