CopyImage

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

( CopyImage אחיזה לטפל  hImage, / / לטפל בתמונה כדי להעתיקUINTuType, / / סוג של התמונה כדי להעתיקintcxDesired, / / הצורך הרוחב של התמונה החדשהintcyDesired, / / הצורך גובה תמונה חדשהUINTfuFlags / / להעתיק דגלים);
 

פרמטרים

hinst
לטפל למופע של המודול המכיל את התמונה שברצונך להעתיק.
uType
מציין את סוג התמונה שברצונך להעתיק. פרמטר זה יכול להיות אחד מהבאים:
ערך משמעות
IMAGE_BITMAP מעתיק מפת סיביות.
IMAGE_CURSOR מעתיק את סמן.
IMAGE_ICON מעתיק את סמל.

cxDesired
מציין את הרוחב הרצוי בפיקסלים של התמונה.
cyDesired
מציין את הגובה הרצוי בפיקסלים של התמונה.
fuFlags
ציון צירוף של הערכים הבאים:
ערך משמעות
LR_COPYDELETEORG מחיקת התמונה המקורית לאחר יצירת העותק.
LR_COPYRETURNORG יוצרת עותק מדויק של התמונה, תוך התעלמות פרמטרי cxDesired ו- cyDesired.
LR_MONOCHROME יוצר תמונה בשחור-לבן חדש.
LR_COPYFROMRESOURCE מנסה לטעון מחדש של משאב הסמל או סמן את קובץ המשאבים המקורי ולא פשוט להעתיק את התמונה הנוכחית. דבר זה שימושי ליצירת עותק בגדלים שונים, כאשר מבחר גדלים של המשאב מכיל קובץ המשאבים. ללא דגל זה, CopyImage מותח את התמונה המקורית לגודל החדש. אם דגל זה מוגדר, CopyImage משתמש בגודל קובץ המשאבים הקרוב ביותר לגודל הרצוי.

פעולה זו תצליח רק אם hImage נטען על-ידי LoadIcon או LoadCursor, או LoadImage עם הדגל LR_SHARED.


להחזיר ערכים

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

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

הערות

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

משאב לשחרר את הפונקציה
מפת סיביות DeleteObject
הסמן DestroyCursor
סמל DestroyIcon

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

QuickInfo

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

ראה גם

מבט כולל על משאבים, פונקציות משאבים, LoadImage

Index