SetProp

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

(BOOL SetProp HWND  hWnd, / / לטפל של חלוןLPCTSTRlpString, / / אטום או כתובת של מחרוזתלטפלhData / / לטפל של נתונים);
 

פרמטרים

hWnd
לטפל אל החלון רשימת המאפיינים שאת מקבלת את הערך החדש.
lpString
המצביע למחרוזת המסתיימת ב- null או מכיל אטום אשר מזהה מחרוזת. אם פרמטר זה הוא אטום, עליו להיות אטום כללית שנוצרו על-ידי קריאה קודמת ל- GlobalAddAtom פונקציה. האטום, ערך של 16 סיביות, יש למקם את המילה מסדר נמוך של lpString; המילה הגבוהות חייב להיות אפס.
hData
לטפל בנתונים להעתיק רשימת המאפיינים. נקודת האחיזה של נתונים יכולים לזהות כל ערך שימושי ליישום.

להחזיר ערכים

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

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

הערות

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

QuickInfo

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

ראה גם

מבט כולל על מאפייני חלון, מתפקד חלון המאפיינים, EnumProps, EnumPropsEx, GetProp, GlobalAddAtom, RemoveProp

Index