ExtractIcon

הפונקציה ExtractIcon מאחזר נקודת אחיזה לסמל קובץ ההפעלה שצוין, ספריית קישור דינאמי (DLL) או קובץ הסמל.

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

(HICON ExtractIcon HINSTANCE  hInst, / / המופע אחיזהLPCTSTRlpszExeFileName, / / שם הקובץ של קובץ עם הסמלUINTnIconIndex / / אינדקס של סמל כדי לחלץ);
 

פרמטרים

hInst
לטפל למופע של היישום קורא לפונקציה.
lpszExeFileName
המצביע למחרוזת המסתיימת ב- null ציון השם של קובץ הפעלה, קובץ DLL או סמל קובץ.
nIconIndex
מציין את אינדקס מבוסס אפס של סמל כדי לאחזר. לדוגמה, אם ערך זה הוא 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 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על shellapi.h.
ייבוא ספריית:השתמש shell32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.

ראה גם

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

Index