CListBox::InitStorage

int InitStorage (int nItems, UINT nBytes );

Wartość zwracany

Jeśli pomyślnie, maksymalną liczbę elementów, które w polu listy można przechowywać przed ponowne przydzielenie pamięci jest potrzebne, w przeciwnym razie LB_ERRSPACE, co oznacza mało pamięci jest dostępny.

Parametry

nItems

Określa liczbę elementów do dodania.

nBytes

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

Uwagi

Przydziela pamięć do przechowywania pozycji pola listy. Wywołanie tej funkcji przed dodaniem duża liczba elementów do CListBox.

Funkcja ta pomaga, przyspieszyć Inicjalizacja listy pól, które mają dużą liczbę elementów (więcej niż 100). Tak, aby kolejne funkcje addString(), InsertStringi Dir podejmuje możliwie najkrótszym czasie, preallocates określoną ilość pamięci. Za pomocą szacunków dla parametrów. Jeśli można przecenić katastrofalny, niektóre dodatkowa pamięć jest przydzielone; Jeśli można ignorować, normalny podział jest używany dla elementów, które przekraczają kwotę przydzielonych wstępnie.

Windows 95 tylko: parametr nItems 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 elementów w polu listy jest ograniczona jedynie iloocią dostępnej pamięci.

Omówie&nie CListBox |nbsp; Klasa członków | Wykres hierarchii

Zobacz teżnbsp;CListBox::CListBox, CListBox::Create, CListBox::ResetContent, LB_INITSTORAGE

Index