CB_ADDSTRING

יישום שולח הודעה CB_ADDSTRING כדי להוסיף מחרוזת תיבת הרשימה של תיבה משולבת. אם התיבה המשולבת אינה כוללת את סגנון CBS_SORT, המחרוזת מתווסף לסוף הרשימה. אחרת, המחרוזת הוכנס לרשימה, הרשימה ממוינת.

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

 

פרמטרים

lpsz
הערך של lParam. המצביע למחרוזת המסתיימת ב- null שיש להוסיף. אם תיצור את התיבה המשולבת בסגנון שצוירו על-ידי הבעלים, אך ללא סגנון CBS_HASSTRINGS, הערך של הפרמטר lpsz מאוחסנים נתוני פריט ולא את המחרוזת זה אחרת הצבע. ניתן לאחזר נתוני פריט או שונה על-ידי שליחת ההודעה CB_GETITEMDATA או CB_SETITEMDATA.

להחזיר ערכים

הערך המוחזר הוא אינדקס מבוסס אפס למחרוזת בתיבת הרשימה של התיבה המשולבת. אם מתרחשת שגיאה, הערך המוחזר הוא CB_ERR. אם אין די שטח פנוי לאחסון המחרוזת החדשה, היא CB_ERRSPACE.

הערות

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

כדי להוסיף מחרוזת במיקום מסוים בתוך הרשימה, השתמש את ההודעה CB_INSERTSTRING.

QuickInfo

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

ראה גם

מבט כולל על תיבות משולבות, משולבת תיבת הודעות, CB_DIR, CB_INSERTSTRING, WM_COMPAREITEM

Index