LB_INITSTORAGE

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

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

 

פרמטרים

cItems
מציין את מספר פריטים כדי להוסיף.

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

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

להחזיר ערכים

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

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

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

הערות

ההודעה LB_INITSTORAGE מסייע להאיץ את האתחול של תיבות רשימה בעלי מספר גדול של פריטים (יותר מ- 100). היא שומרת את כמות הזיכרון שצוין כך בהודעות LB_ADDSTRING, LB_INSERTSTRING, LB_DIR, LB_ADDFILE לקחת בזמן הקצר ביותר. באפשרותך להשתמש הערכות עבור הפרמטרים cItems ו cb . אם אתה שלא להעריך גם הזיכרון מוקצה; אם אתה תזלזל בחוקי הקצאת רגילה משמש עבור פריטים שגודלם עולה על הכמות המבוקשת.

QuickInfo

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

ראה גם

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

Index