הפונקציה CopyImage יוצר תמונה חדש (הסמל, הסמן או מפת סיביות) ומעתיקה את התכונות של התמונה שצוינה החדשה. אם יש צורך, הפונקציה מתיחת סיביות כדי להתאים לגודל הרצוי של התמונה החדשה.
( CopyImage אחיזה לטפל hImage, / / לטפל בתמונה כדי להעתיקUINTuType, / / סוג של התמונה כדי להעתיקintcxDesired, / / הצורך הרוחב של התמונה החדשהintcyDesired, / / הצורך גובה תמונה חדשהUINTfuFlags / / להעתיק דגלים);
| ערך | משמעות |
|---|---|
| IMAGE_BITMAP | מעתיק מפת סיביות. |
| IMAGE_CURSOR | מעתיק את סמן. |
| IMAGE_ICON | מעתיק את סמל. |
| ערך | משמעות |
|---|---|
| LR_COPYDELETEORG | מחיקת התמונה המקורית לאחר יצירת העותק. |
| LR_COPYRETURNORG | יוצרת עותק מדויק של התמונה, תוך התעלמות פרמטרי cxDesired ו- cyDesired. |
| LR_MONOCHROME | יוצר תמונה בשחור-לבן חדש. |
| LR_COPYFROMRESOURCE | מנסה לטעון מחדש של משאב הסמל או סמן את קובץ המשאבים המקורי ולא פשוט להעתיק את התמונה הנוכחית. דבר זה שימושי ליצירת עותק בגדלים שונים, כאשר מבחר גדלים של המשאב מכיל קובץ המשאבים. ללא דגל זה, CopyImage מותח את התמונה המקורית לגודל החדש. אם דגל זה מוגדר, CopyImage משתמש בגודל קובץ המשאבים הקרוב ביותר לגודל הרצוי. פעולה זו תצליח רק אם hImage נטען על-ידי LoadIcon או LoadCursor, או LoadImage עם הדגל LR_SHARED. |
אם הפונקציה מצליחה, הערך המוחזר הוא המזהה הייחודי שנוצר לאחרונה בתמונה.
אם הפעולה תיכשל, הערך המוחזר הוא NULL. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
עם סיום השימוש במשאב, באפשרותך לשחרר זיכרון משויכים שלו על-ידי קריאה אחת מפונקציות בטבלה הבאה.
| משאב | לשחרר את הפונקציה |
|---|---|
| מפת סיביות | DeleteObject |
| הסמן | DestroyCursor |
| סמל | DestroyIcon |
המערכת ימחק באופן אוטומטי את המשאב כאשר התהליך שלו מסתיים, עם זאת, קורא את הפונקציה המתאימה חוסכת זיכרון ו הקטנת הגודל של ערכת העבודה של תהליך.
nbsp; Windows &NT: מחייב גירסה 3.5 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
מבט כולל על משאבים, פונקציות משאבים, LoadImage