CB_INITSTORAGE

[זהו תיעוד ראשוני וניתנים לשינוי.]

יישום שליחת ההודעה CB_INITSTORAGE לפני הוספת מספר גדול של פריטים בחלק תיבת הרשימה של תיבה משולבת. הודעה זו מקצה זיכרון לאחסון פריטים בתיבת רשימה.

CB_INITSTORAGE wParam = cItems (WPARAM) (int);  / / מספר פריטים כדי להוסיף lParam = cb (LPARAM) (DWORD);    / / כמות זיכרון כדי להקצות, בבתים 

 

פרמטרים

cItems
מציין את מספר פריטים כדי להוסיף.
cb
מציין את כמות הזיכרון כדי להקצות עבור מחרוזות פריט, בבתים.

להחזיר ערכים

אם ההודעה היא מוצלחת, הערך המוחזר הוא המספר הכולל של פריטים עבורם הזיכרון יש כבר pre-allocated, כלומר, המספר הכולל של פריטים שנוספו על-ידי כל ההודעות CB_INITSTORAGE מוצלחת.

אם ההודעה נכשל, ערך ההחזרה הוא CB_ERRSPACE.

Windows NT: עבור Windows NT גירסה 4.0, הודעה זו לא להקצות כמות הזיכרון; שצוין עם זאת, היא מחזירה תמיד את הערך שצוין בפרמטר cItems . עבור Windows NT גירסה 5.0, ההודעה מקצה זיכרון ומחזירה הצלחה וערכי שגיאה המתואר לעיל.

הערות

ההודעה CB_INITSTORAGE מסייע להאיץ את האתחול של תיבות משולבות בעלי מספר גדול של פריטים (מעל 100). היא שומרת את כמות הזיכרון שצוין כך בהודעות CB_ADDSTRING CB_INSERTSTRING, CB_DIR לקחת בזמן הקצר ביותר. באפשרותך להשתמש הערכות עבור הפרמטרים cItems ו cb . אם אתה שלא להעריך גם הזיכרון מוקצה, אם תזלזל בחוקי, הקצאת רגילה משמש עבור פריטים שגודלם עולה על הכמות המבוקשת.

QuickInfo

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

ראה גם

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

Index