LB_INITSTORAGE

Aplikacja wysyła komunikat LB_INITSTORAGE, przed dodaniem duża liczba elementów z pola listy. Komunikat ten przydziela pamięć do przechowywania elementów pole listy.

LB_INITSTORAGE wParam = cItems (WPARAM) (int);  / / liczba elementów do dodania fikcyjnymi = cb (FIKCYJNYMI) (DWORD);   / / kwota pamięci do alokacji, w bajtach 

 

Parametry

cItems
Określa liczbę elementów do dodania.

Systemu Windows 95 i Windows 98: Parametr wParam jest ograniczone do wartości 16-bitowe. Oznacza to, że pola listy nie może zawierać więcej niż 32 767 elementów. Chociaż liczba elementów jest ograniczona, całkowity rozmiar w bajtach elementów w polu listy jest ograniczona jedynie iloocią dostępnej pamięci.

cb
Określa ilość pamięci, w bajtach, przydzielić dla elementu ciągi.

Zwraca wartości

Jeśli wiadomość jest pomyślne, wartość zwracany jest całkowita liczba elementów wstępnie dla których pamięci ma zostały przyznane, oznacza to, że całkowita liczba elementów dodanych przez wszystkie udane wiadomości LB_INITSTORAGE.

Jeśli wiadomość nie powiedzie się, wartość zwracany jest LB_ERRSPACE.

Systemu Windows NT: W systemie Windows NT w wersji 4.0 ten komunikat nie przydzielał określoną ilość pamięci; jednak zawsze zwraca wartość określonej w parametrze cItems . W systemie Windows NT w wersji 5.0 wiadomości przydziela pamięć i zwraca wartości sukces i błąd opisany powyżej.

Uwagi

Wiadomość LB_INITSTORAGE pomaga, przyspieszyć Inicjalizacja listy pól, które mają dużą liczbę elementów (więcej niż 100). Tak, aby kolejne komunikaty LB_ADDSTRING, LB_INSERTSTRING, LB_DIR i LB_ADDFILE podjąć najkrótszym czasie zastrzega sobie określoną ilość pamięci. Szacunki można używać parametrów cItems i cb . Jeśli można przecenić katastrofalny, dodatkowa pamięć jest przydzielone; Jeśli można ignorować, normalny podział jest używany dla elementów, które przekraczają kwoty żądanej.

Skrócone informacje

nbsp; Windows &NT: wymaga w wersji 4.0 lub nowszej.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.

Zobacz też

Omówienie pola listy, listy pole wiadomości, LB_ADDFILE, LB_ADDSTRING, LB_DIR, LB_INSERTSTRING

Index