ExtractIconEx

הפונקציה ExtractIconEx יוצרת מערך של נקודות האחיזה כדי לחלץ את קובץ ההפעלה שצוין, ספריית קישור דינאמי (DLL) או קובץ סמל סמלים גדולים או קטנים.

(UINT ExtractIconEx LPCTSTR  lpszFile, int  nIconIndex, HICON עד  * phiconLarge, HICON עד  * phiconSmall, UINT  nIcons);
 

פרמטרים

lpszFile
המצביע למחרוזת המסתיימת ב- null ציון השם של קובץ הפעלה, קובץ DLL או סמל הקובץ שממנו תישלף סמלים.
nIconIndex
מציין את אינדקס מבוסס אפס של סמל ראשון כדי לחלץ. לדוגמה, אם ערך זה אינו אפס, הפונקציה מחלצת את הסמל הראשון בקובץ שצוין.

אם ערך זה הוא – 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, הערך המוחזר הוא מספר סמלי הכלולים בקובץ שצוין. אחרת, הערך המוחזר הוא מספר סמלי חולצה בהצלחה מקובץ.

הערות

עליך להשמיד את כל הסמלים לחלץ על ExtractIconEx על-ידי קריאה לפונקציה DestroyIcon.

כדי לאחזר את הממדים של סמלים גדולים וקטנים, השתמש GetSystemMetrics הפונקציה עם דגלים SM_CXICON, SM_CYICON, SM_CXSMICON, SM_CYSMICON.

חלונות CE: הפרמטר nIconIndex חייב להיות אפס או –N כאשר n הוא מזהה המשאב שצוין. הפרמטר nIcons חייב להיות 1.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.5 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על shellapi.h.
ייבוא ספריית:השתמש shell32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.

ראה גם

סקירה כללית של סמלים, סמל פונקציות, DestroyIcon, ExtractIcon

Index