ExtractIconEx

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

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

Параметри

lpszFile
Вказівник на рядок вказує ім'я виконуваного файлу, бібліотеку DLL або значок файлу, з якого буде витягнуто значки.
nIconIndex
Визначає COLUMN індекс перший значок, щоб витягти. Наприклад, якщо це значення нуль, функція екстракти перший значок у вказаний файл.

Якщо це значення – 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