LB_SELECTSTRING

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

LB_SELECTSTRING wParam = indexStart (WPARAM);        / / פריט לפני תחילת החיפוש lParam = lpszFind (LPARAM) (LPCTSTR);  / / כתובת של מחרוזת החיפוש 

 

פרמטרים

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

Windows 95 ו- Windows 98: הפרמטר wParam מוגבלת לערכים של 16 סיביות. משמעות הדבר היא תיבות רשימה אינה יכולה להכיל פריטים יותר 32,767. למרות מספר הפריטים היא מוגבלת, הגודל הכולל בבתים של הפריטים בתיבת רשימה מוגבל רק על-ידי זיכרון זמין.

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

להחזיר ערכים

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

הערות

לגלול תיבת רשימה, במידת הצורך, להביא את הפריט הנבחר אל תצוגה.

אל תשתמש הודעה זו עם תיבת רשימה הכוללת את סגנון LBS_MULTIPLESEL.

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

אם אתה יוצר תיבת הרשימה בסגנון שצוירו על-ידי הבעלים, אך ללא סגנון LBS_HASSTRINGS, הודעה זו מחזירה האינדקס של הפריט שערכו רב (שסופק כפרמטר lParam ההודעה LB_ADDSTRING או LB_INSERTSTRING) מתאים את הערך שסופק כפרמטר lParam של LB_SELECTSTRING.

QuickInfo

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

ראה גם

מבט כולל על תיבות רשימה, תיבת רשימה הודעות, LB_ADDSTRING, LB_FINDSTRING, LB_INSERTSTRING

Index