LookupIconIdFromDirectoryEx

הפונקציה LookupIconIdFromDirectoryEx מחפשת דרך הסמל או סמן נתונים עבור סמל או הסמן המתאימה ביותר התקן התצוגה הנוכחית.

 int LookupIconIdFromDirectoryEx ( PBYTE  presbits, / / כתובת של נתוני משאביםBOOLfIcon, / / סמל או סמן בדגלintcxDesired, / / רוחב של סמל או הסמן הרצויintcyDesired, / / גובה של סמל או הסמן הרצויUINTדגלים / / דגלי משאב);
 

פרמטרים

presbits
מצביע על הנתונים ספריה הסמל או הסמן. מכיוון שפונקציית אינו מאמת נתוני משאבים, הוא גורם של תקלת הגנה כללית (GP) או מחזירה ערך לא מוגדר אם presbits לא הצבעה לנתוני משאב חוקי.
fIcon
קביעה אם סמל או סמן המבוקש. אם פרמטר זה הוא TRUE, הפונקציה מחפש סמל; אם הפרמטר הוא FALSE, הפונקציה מחפש סמן.
cxDesired
מציין את הרוחב הרצוי, בפיקסלים, של הסמל. אם פרמטר זה הוא אפס, הפונקציה משתמשת SM_CXICON SM_CXCURSOR מערכת מטרי הערך או.
cyDesired
מציין את הגובה הרצוי, בפיקסלים, של הסמל. אם פרמטר זה הוא אפס, הפונקציה משתמשת SM_CYICON SM_CYCURSOR מערכת מטרי הערך או.
דגלים
ציון צירוף של הערכים הבאים:
ערך משמעות
LR_DEFAULTCOLOR משתמש תבנית ברירת המחדל של צבע.
LR_MONOCHROME יצירת סמל בשחור-לבן או הסמן.

להחזיר ערכים

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

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

הערות

קובץ משאב מסוג RT_GROUP_ICON (RT_GROUP_CURSOR מציינת סמנים) מכיל נתונים סמל (או הסמן) במספר תבניות תלוי-התקן, שאינו תלוי-התקן. LookupIconIdFromDirectoryEx מחפש קובץ המשאבים עבור סמל (או הסמן) אשר הכי מתאימה התקן התצוגה הנוכחית ומחזירה את המזהה השלם שלו. הפונקציות FindResource ו- FindResourceEx להשתמש במאקרו MAKEINTRESOURCE עם מזהה זה כדי לאתר את המשאב במודול.

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

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

QuickInfo

nbsp; Windows &NT: מחייב גירסה 4.0 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.

ראה גם

סקירה כללית של סמלים, סמל פונקציות, CreateIconFromResourceEx, CreateIconIndirect, FindResource, FindResourceEx, GetIconInfo, LoadCursor, LoadIcon, LoadImage, LookupIconIdFromDirectory, MAKEINTRESOURCE

Index