CListBox::InitStorage

Articolo
03/05/2013

Alloca memoria per archiviare gli elementi della casella di riepilogo.

int InitStorage(
   int nItems,
   UINT nBytes 
);

Parametri

nItems
Specifica il numero di elementi da aggiungere.
nBytes
Specifica la quantità di memoria, in byte, per allocare per le stringhe dell'elemento.

Valore restituito

Se l'operazione riesce, il numero massimo di elementi che la casella di riepilogo può archiviare prima di una riallocazione di memoria si richiedono in caso contrario, LB_ERRSPACE, significante memoria insufficiente è disponibile.

Note

Chiamare questa funzione dell'aggiunta di un numero elevato di elementi a CListBox.

Questa funzione consente di velocizzare l'inizializzazione delle caselle di riepilogo con un numero elevato di elementi (più di 100).Preassegna la quantità di memoria specificata in modo che le funzioni successive AddString, InsertStringe Dir richiedere più breve tempo possibile.È possibile utilizzare le stime per i parametri.Se la sopravvalutazione, la memoria aggiuntiva è allocato, se sottostima, l'allocazione normale viene utilizzato per gli elementi che supera l'importo preassegnato.

Windows 95/98 solo: Il parametro nItems è limitato ai valori a 16 bit.Ciò significa che le caselle di riepilogo non possono contenere più di 32.767 elementi.Sebbene il numero di elementi sia limitato, la dimensione totale degli elementi in una casella di riepilogo è limitata solo dalla memoria disponibile.

Esempio

// Initialize the storage of the list box to be 256 strings with
// about 10 characters per string, performance improvement.
int n = m_myListBox.InitStorage(256, 10);
ASSERT(n != LB_ERRSPACE);

// Add 256 items to the list box.
CString str;
for (int i = 0; i < 256; i++)
{
   str.Format(_T("item string %d"), i);
   m_myListBox.AddString( str );
}