WM_COMPAREITEM

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

 WM_COMPAREITEM idCtl = wParam;                       / / לשלוט מזהה lpcis = lParam (LPCOMPAREITEMSTRUCT); / / מבנה עם פריטים 

 

פרמטרים

idCtl
הערך של wParam. קביעת המזהה של הפקד שממנו נשלחה ההודעה WM_COMPAREITEM.
lpcis
הערך של lParam. מצביע למבנה COMPAREITEMSTRUCT המכיל את מזהי ונתונים שסופק על-ידי היישום עבור שני הפריטים בתיבה המשולבת או רשימה.

להחזיר ערכים

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

ערך משמעות
– 1 פריט 1 לפני פריט 2 בסדר ממוין.
0 פריטים 1 ו- 2 הם שווי ערך בסדר ממוין.
1 1 להלן פריט 2 בסדר ממוין.

הערות

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

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

QuickInfo

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

ראה גם

מבט כולל על תיבות משולבות, הודעות בתיבת המשולבת, COMPAREITEMSTRUCT

Index