המערכת שולחת את ההודעה WM_COMPAREITEM כדי לקבוע את מיקומו היחסי של פריט חדש ברשימה הממוינת של תיבת רשימה או תיבה משולבת שצוירו על-ידי הבעלים. בכל פעם שהיישום מוסיף פריט חדש, המערכת שולחת הודעה זו אל הבעלים של תיבה משולבת או תיבת רשימה שנוצרה בסגנון CBS_SORT או LBS_SORT.
WM_COMPAREITEM idCtl = wParam; / / לשלוט מזהה lpcis = lParam (LPCOMPAREITEMSTRUCT); / / מבנה עם פריטים
הערך המוחזר מציין המיקום היחסי של שני פריטים. ייתכן שהוא אחת הפעולות הבאות:
| ערך | משמעות |
|---|---|
| – 1 | פריט 1 לפני פריט 2 בסדר ממוין. |
| 0 | פריטים 1 ו- 2 הם שווי ערך בסדר ממוין. |
| 1 | 1 להלן פריט 2 בסדר ממוין. |
כאשר הבעלים של תיבת רשימה או תיבה משולבת שצוירו על-ידי הבעלים של מקבל הודעה זו, הבעלים מחזירה ערך המציין אילו מבין הפריטים שצוינו על-ידי מבנה COMPAREITEMSTRUCT יופיע לפני השני. בדרך כלל, המערכת שולחת הודעה זו מספר פעמים עד זה קובע את המיקום המדויק עבור הפריט החדש.
אם הליך תיבת הדו-שיח מטפל הודעה זו, אותה עליו לבצע המרה של הערך המוחזר המבוקש כדי BOOL, להחזיר את הערך ישירות. אין התייחסות הערך DWL_MSGRESULT המוגדר על-ידי הפונקציה SetWindowLong.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
מבט כולל על תיבות משולבות, הודעות בתיבת המשולבת, COMPAREITEMSTRUCT