Функция ExtractIconEx

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

Синтаксис

UINT ExtractIconEx(

      LPCTSTR lpszFile,
      int     nIconIndex,
      HICON   *phiconLarge,
      HICON   *phiconSmall,
      UINT    nIcons
);

Параметры

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

Размещение и совместимость ExtractIconEx
К Windows XP Да
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 3.5 и выше
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
С Windows 2003 Server Да
е Windows 2000 Server Да
р Windows NT Server Да версии 3.5 и выше
в
е
р
Используемая библиотека Shell32.lib
Используемая DLL shell32.dll
Заголовочный файл
- объявлено в Shellapi.h
- включено в -
Unicode Реализуется как версии ANSI и Unicode
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz