LB_INITSTORAGE

Et program sender meldingen LB_INITSTORAGE før du legger til et stort antall elementer til en liste. Denne meldingen tildeler minne for lagring av boksen listeelementer.

LB_INITSTORAGE wParam = (WPARAM) (int) cItems;  / / antall elementer du vil legge til lParam = (LPARAM) (DWORD) cb;   / / beløp av minne til å tildele, i byte 

 

Parametere

cItems
Angir hvor mange varer du vil legge til.

Windows 95 og Windows 98: Parameteren wParam er begrenset til 16-biters verdier. Dette betyr at lister ikke kan inneholde mer enn 32 767 elementer. Selv om antall elementer er begrenset, er den totale størrelsen i byte på elementer i en liste begrenset bare av tilgjengelig minne.

cb
Angir mengden minne, i byte, for å tildele for element-strenger.

Returverdier

Hvis meldingen er vellykket, er returverdien det totale antallet elementer som minne har blitt forhåndstildeles, det vil si det totale antallet elementer som er lagt til av alle vellykkede LB_INITSTORAGE-meldinger.

Hvis meldingen mislykkes, er returverdien LB_ERRSPACE.

Windows NT: For Windows NT versjon 4.0 tildeler ikke denne meldingen angitte mengden minne; men returnerer den alltid verdien som er angitt i parameteren cItems . For Windows NT versjon 5.0, meldingen tildeler minne og returnerer suksess og feil verdier som er beskrevet ovenfor.

Merknader

Meldingen LB_INITSTORAGE bidrar til å øke hastigheten på initialisering av lister som har et stort antall elementer (mer enn 100). Den angitte mengden minne reserveres slik at påfølgende meldinger fra LB_ADDSTRING, LB_INSERTSTRING, LB_DIR og LB_ADDFILE ta på kortest mulig tid. Du kan bruke estimater for cItems og cb -parametere. Hvis du overvurdere, tildeles ekstra minne; Hvis du undervurdere, brukes den normale fordelingen for elementer som overskrider det forespurte beløpet.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 4.0 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winuser.h.

Se også

Listen boksene oversikt, listen boksen meldinger, LB_ADDFILE, LB_ADDSTRING, LB_DIR, LB_INSERTSTRING

Index