ExtractIconEx

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

(UINT ExtractIconEx LPCTSTR  lpszFile, int  nIconIndex, HICON далеко  * phiconLarge, HICON далеко  * phiconSmall, UINT  nIcons);
 

Параметры

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

Если это значение равно –1 и phIconLarge и phiconSmall , как NULL, функция возвращает общее количество значков в указанном файле. Если этот файл находится в исполняемый файл или DLL, возвращаемое значение — количество RT_GROUP_ICON ресурсов. Если файл является.ICO-файл, возвращаемое значение — 1.

Windows 95, Windows NT 4.0 и более поздних: Если это значение является отрицательным числом, и phIconLarge или phiconSmall не равно NULL, функция начинает путем извлечения значка, чей идентификатор ресурса равно абсолютному значению nIconIndex. К примеру используйте для извлечения значка, чей идентификатор ресурса-3 -3.

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

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

Если параметр nIconIndex имеет значение -1, параметр phiconLarge имеет значение NULL, и параметр phiconSmall имеет значение NULL, возвращаемое значение — количество икон, содержащиеся в указанном файле. В противном случае возвращаемое значение является количество иконок, успешно извлекаются из файла.

Примечания

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

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

Windows CE: Параметр nIconIndex должен быть нулевым или –N где N — идентификатор заданного ресурса. Параметр nIcons должен быть 1.

QuickInfo

nbsp; Windows &NT: требует версии 3.5 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в shellapi.h.
Импорта библиотеки:Используйте shell32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Обзор значки, значок функции, DestroyIcon, ExtractIcon

Index