LB_INSERTSTRING

יישום שולח הודעת LB_INSERTSTRING כדי להוסיף מחרוזת לתוך תיבת רשימה. בניגוד ההודעה LB_ADDSTRING ההודעה LB_INSERTSTRING אינו גורם רשימה בסגנון LBS_SORT למיון.

LB_INSERTSTRING wParam = אינדקס (WPARAM);          / / פריט אינדקס lParam = lpsz (LPARAM) (LPCTSTR); / / כתובת של מחרוזת כדי להוסיף 

 

פרמטרים

אינדקס

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

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

lpsz

הערך של lParam. המצביע למחרוזת המסתיימת ב- null להכנסה.

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

להחזיר ערכים

הערך המוחזר הוא האינדקס של המיקום שבו הוכנס המחרוזת. אם מתרחשת שגיאה, הערך המוחזר הוא LB_ERR. אם יש די מקום לאחסון המחרוזת החדשה, ערך ההחזרה הוא LB_ERRSPACE.

QuickInfo

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

ראה גם

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