Функция ExtractIconEx

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

Синтаксис

Параметры

lpszFile

[in] Указатель на строку с завершающим нулем, определяющую имя исполняемого файла, динамически подключаемой библиотеки (DLL), или файла значка, из которого(ой) значки должны быть извлечены.

nIconIndex

[in] Определяет отсчитываемый от нуля индекс первого извлекаемого значка. Например, если это значение - нуль, функция извлекает первый значок в указанном файле.

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

Windows 95/98/Me, Windows NT 4.0 и позже: Если это значение - отрицательное число, а параметр phiconLarge или phiconSmall - не NULL, функция начинает извлечение значков, чей идентификатор ресурса равен абсолютному значению параметра nIconIndex. Например, используйте – (минус)3, чтобы извлечь значок, идентификатор ресурса которого равен 3.

phiconLarge

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

phiconSmall

[out] Указатель на массив дескрипторов значка, который получает дескрипторы маленьких значков, извлеченных из файла. Если этот параметр - NULL, никакие маленькие значки не извлекаются из файла.

nIcons

[in] Определяет число значков, извлекаемых из файла.

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

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

Замечания

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

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

Windows 95/98/Me: ExtractIconW поддерживается программой Microsoft Layer for Unicode (MSLU). Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Смотри также

Обзор Значки, Функции, используемые значками, DestroyIcon, ExtractIcon