LoadImage

הפונקציה LoadImage טוענת סמל, הסמן, או מפת סיביות.

( LoadImage אחיזה HINSTANCE  hinst, / / המזהה הייחודי של המופע המכיל את התמונהLPCTSTRlpszName, / / שם או מזהה של התמונהUINTuType, / / סוג של התמונהintcxDesired, / / הצורך רוחב intcyDesired, / / הצורך גובהUINTfuLoad / / לטעון דגלים);
 

פרמטרים

hinst

לטפל למופע של המודול המכיל את התמונה שיש לטעון. כדי לטעון תמונה OEM, הגדר פרמטר זה אפס.

lpszName

לטפל לתמונה כדי לטעון.

אם הפרמטר hinst הוא שאינו NULL תכלול הפרמטר fuLoad LR_LOADFROMFILE, lpszName הוא מצביע מחרוזת המסתיימת ב- null, אשר מכיל את השם של משאב תמונה במודול hinst.

אם hinst הוא NULL, LR_LOADFROMFILE לא צוין, word מסדר נמוך של פרמטר זה חייב להיות המזהה של תמונת ה-OEM כדי לטעון. מזהים תמונה של יצרן הציוד המקורי מוגדרים ב- WINUSER.H, ואין להם הבאה מוסיפה קידומת:

קידומת	משמעות
OBM_	מפות סיביות של OEM
OIC_	סמלים OEM
OCR_	סמנים OEM

אם הפרמטר fuLoad כוללת את הערך LR_LOADFROMFILE, lpszName הוא שם הקובץ שמכיל את התמונה.

uType

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

ערך	משמעות
IMAGE_BITMAP	טוען מפת סיביות.
IMAGE_CURSOR	טוען הסמן.
IMAGE_ICON	טוען סמל.

cxDesired

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

cyDesired

ציון הגובה, בפיקסלים, של סמל או של הסמן. אם פרמטר זה הוא אפס הפרמטר fuLoad הוא LR_DEFAULTSIZE, הפונקציה משתמשת SM_CYICON SM_CYCURSOR מערכת מטרי הערך או כדי לקבוע את הגובה. אם פרמטר זה הוא אפס, לא נעשה שימוש LR_DEFAULTSIZE, הפונקציה משתמשת גובה משאב ממשי.

fuLoad

ציון צירוף של הערכים הבאים:

ערך	משמעות
LR_DEFAULTCOLOR	דגל ברירת המחדל; הוא עושה כלום. כל זה אומר הוא "לא LR_MONOCHROME".
LR_CREATEDIBSECTION	כאשר הפרמטר uType מציין IMAGE_BITMAP, גורמת הפונקציה להחזיר את מפת סיביות בסעיף דיב במקום במפת סיביות תואמת. דגל זה שימושי עבור טעינת מפת סיביות ללא מיפוי הצבעים של התקן התצוגה.
LR_DEFAULTSIZE	משתמש את הרוחב או הגובה שצוין על-ידי מערכת הערכים מטרי של סמנים או סמלים, אם הערכים cxDesired או cyDesired מוגדר כאפס. אם דגל זה לא צוין, cxDesired ו- cyDesired מוגדרים לאפס, הפונקציה משתמשת גודל משאב ממשי. אם המשאב מכיל תמונות מרובות, הפונקציה משתמשת את הגודל של התמונה הראשונה.
LR_LOADFROMFILE	טוען את התמונה מתוך הקובץ שצוין על-ידי הפרמטר lpszName . אם דגל זה לא צוין, lpszName הוא השם של משאב.
LR_LOADMAP3DCOLORS	מבצע חיפוש בטבלת הצבע של התמונה ומחליף את גווני אפור הבאים לצבע תלת-ממד התואם:

	צבע	הוחלפו
	אפור כהה, RGB(128,128,128)	COLOR_3DSHADOW
	אפור, RGB(192,192,192)	COLOR_3DFACE
	אפור בהיר, RGB(223,223,223)	COLOR_3DLIGHT

LR_LOADTRANSPARENT	מאחזר את ערך הצבע של הפיקסל הראשונה בתמונה ומחליף את הערך המתאים בטבלת הצבע עם צבע ברירת המחדל של חלון (COLOR_WINDOW). כל הפיקסלים בתמונה המשתמשות ערך זה להפוך צבע ברירת המחדל של חלון. ערך זה חל רק על תמונות המכילות טבלאות צבע המתאים. אם fuLoad כולל ערכי LR_LOADTRANSPARENT ו- LR_LOADMAP3DCOLORS, LRLOADTRANSPARENT קדימות. עם זאת, הערך של טבלת צבע מוחלף COLOR_3DFACE ולא COLOR_WINDOW.
LR_MONOCHROME	טוען את התמונה בשחור-לבן.
LR_SHARED	משתף את נקודת האחיזה של התמונה אם התמונה נטען פעמים מרובות. אם לא מוגדר LR_SHARED, לשיחה נוספת כדי LoadImage עבור אותו משאב לטעון את התמונה שוב ולחזור נקודת אחיזה שונה. אל תשתמש ב- LR_SHARED עבור תמונות המכילות גדלים לא תקני, עשוי להשתנות לאחר הטעינה, או הנטענת מקובץ. Windows 95 ו- Windows 98: הפונקציה מחפשת את התמונה הראשונה עם שם המשאב המבוקש בזיכרון המטמון, להתחשב בגודל המבוקש.
LR_VGACOLOR	נעשה שימוש נכון בצבעים VGA.

להחזיר ערכים

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

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

הערות

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

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

חלונות CE: פרמטרים cxDesired ו- cyDesired חייב להיות אפס עבור IMAGE_BITMAP.

Windows CE אינו תומך מתיחות וכיווץ של סמלים.

הפרמטר fuLoad חייב להיות אפס (= =-LR_DEFAULTCOLOR).

אם מדובר בפלטפורמה שאינה תומכת סמני עכבר, אין באפשרותך לציין ערכי SM_CXCURSOR ו- SM_CYCURSOR בפרמטרים cxDesired ו- cyDesired , אין באפשרותך לציין IMAGE_CURSOR עבור הפרמטר uType.

אם מדובר פלטפורמה שתומכת סמני עכבר, באפשרותך לציין SM_CXCURSOR SM_CYCURSOR cxDesired ו cyDesired פרמטרים ולאחר IMAGE_CURSOR בפרמטר uType.

QuickInfo

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

ראה גם

מבט כולל על משאבים, המשאב מתפקד, CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon

Index