Функция ExtractIcon

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

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

Синтаксис

HICON ExtractIcon(

     HINSTANCE    hInst,
     LPCTSTR    lpszExeFileName,
     UINT    nIconIndex
);

Параметры

hInst

[in] Дескриптор экземпляра приложения, вызывающего функцию.

lpszExeFileName

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

nIconIndex

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

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

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

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

Возвращаемое значение - дескриптор значка. Если определенный файл не был исполняемым файлом, динамически подключаемой библиотекой (DLL) или файлом значка, возвращается 1. Если никакие значки не были найдены в файле, возвращаемое значение - NULL.

Замечания

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

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

Смотри также

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

Размещение и совместимость ExtractIcon
К 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