LB_FINDSTRINGEXACT

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

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

 

פרמטרים

indexStart

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

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

lpszFind

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

להחזיר ערכים

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

הערות

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

QuickInfo

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

ראה גם

מבט כולל על תיבות רשימה, תיבת רשימה הודעות, LB_FINDSTRING, LB_SELECTSTRING, WM_COMPAREITEM

Index