LoadIcon

הפונקציה LoadIcon טוען את המשאב שצוין סמל מתוך קובץ ההפעלה (.קובץ EXE) המשויך מופע של יישום. פונקציה זו הוחלף על-ידי הפונקציה LoadImage

(HICON LoadIcon HINSTANCE  hInstance, / / לטפל מופע היישוםLPCTSTRlpIconName / / סמל-שם משאב מחרוזת או סמל / / מזהה);
 

פרמטרים

hInstance
לטפל למופע של קובץ ההפעלה שלו מכילה את סמל טעינת המודול. פרמטר זה חייב להיות NULL כאשר נטען סמל רגיל.
lpIconName
המצביע למחרוזת המסתיימת ב- null המכיל את השם של משאב הסמל שיש לטעון. לחלופין, פרמטר זה יכול להכיל את מזהה המשאב ב- word מסדר נמוך, ואפס את המילה הגבוהות. להשתמש במאקרו MAKEINTRESOURCE ליצירת ערך זה.

כדי להשתמש באחד מסמלי מראש, להגדיר את הפרמטר hInstance NULL, את הפרמטר lpIconName לאחד מהבאים:
ערך תיאור
IDI_APPLICATION סמל היישום המשמש כברירת מחדל.
IDI_ASTERISK זהה IDI_INFORMATION.
IDI_ERROR סמל בצורת יד.
IDI_EXCLAMATION זהה IDI_WARNING.
IDI_HAND זהה IDI_ERROR.
IDI_INFORMATION סמל כוכבית.
IDI_QUESTION סימן שאלה.
IDI_WARNING סמל סימן קריאה.
IDI_WINLOGO סמל הלוגו של Windows.

להחזיר ערכים

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

אם הפעולה תיכשל, הערך המוחזר הוא NULL. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.

הערות

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

LoadIcon רק לטעון סמל שאת גודלו מתאים SM_CXICON ואת SM_CYICON מערכת בערכים מטריים. השתמש בפונקציה LoadImage כדי לטעון את הסמלים של גדלים אחרים.

חלונות CE: סמלים שהוגדרו מראש (IDI_ *) אינם נתמכים.

ב- Windows CE 1.0, הסמל להיות קצת שני לכל פיקסל (.ic2) הסמל או סמל בשחור-לבן.

ראה גם

סקירה כללית של סמלים, סמל פונקציות, CreateIcon, LoadImage, MAKEINTRESOURCE

Index