ExtractIcon

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

Щоб отримати масив ручки на великі або маленькі іконки, слід використовувати функцію ExtractIconEx.

(HICON ExtractIcon HINSTANCE  hInst, / / наприклад ручкоюLPCTSTRlpszExeFileName, / / ім'я файлу з піктограмоюUINTnIconIndex / / індекс піктограми для видобування);
 

Параметри

hInst

Обробляти до прикладу застосування виклику функції.

lpszExeFileName

Вказівник на рядок вказує ім'я виконуваного файлу, бібліотеку DLL або значок файлу.

nIconIndex

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

Якщо це значення – 1, функція повертає кількість ікон у вказаний файл. Якщо файл є виконуваний файл або DLL, значення, що повертається є кількість ресурсів RT_GROUP_ICON. Якщо файл знаходиться на.ICO файлу, значення-1.

Windows 95, Windows NT 4.0 та пізніших версій: Якщо це значення є від'ємне число не дорівнює -1, функція повертає ручку на значок вказаний файл, чиї ідентифікатор ресурсів дорівнює абсолютного значення nIconIndex. Наприклад, використайте -3, щоб витягти значок, чиї ідентифікатор ресурсів-3. Щоб вилучити значок, чиї ідентифікатор ресурсів-1, функція ExtractIconEx.

Повернення значень

Значення, що повертається, є дескриптор піктограми. Якщо вказаний файл не був виконуваний файл, бібліотеку DLL або піктограму файлу, повернення-1. Якщо немає піктограми були знайдені у файлі, значення, що повертається, є NULL.

Зауваження

Ви повинні знищити дескриптор піктограми, повернутих ExtractIcon шляхом виклику функції DestroyIcon.

QuickInfo

nbsp; Windows &NT: вимагає 3.1 або пізнішої версії.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Не підтримується.
Заголовка:Оголошена в shellapi.h.
Імпортувати бібліотеки:Використання shell32.lib.
Юнікод:Реалізований у вигляді Юнікод і ANSI версії на Windows NT.

Дивіться також

Огляд іконки, значок функції, DestroyIcon, ExtractIconEx

Index