CComboBox::InitStorage

Articolo
03/05/2013

Alloca memoria per archiviare gli elementi della casella di riepilogo nella parte di tipo casella di riepilogo della casella combinata.

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 parte di tipo casella di riepilogo della casella combinata può archiviare prima di una riallocazione di memoria si richiedono in caso contrario, CB_ERRSPACE, significante memoria insufficiente è disponibile.

Note

Chiamare questa funzione prima di aggiungere un numero elevato di elementi alla parte di tipo casella di riepilogo CComboBox.

Windows 95/98 solo: Il parametro wParam è 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.

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.

Esempio

// Initialize the storage of the combo box to be 256 strings with
// about 10 characters per string, performance improvement.
int nAlloc = pmyComboBox->InitStorage(256, 10);
ASSERT(nAlloc != CB_ERRSPACE);

// Add 256 items to the combo box.
CString strAdd;
for (int i = 0; i < 256; i++)
{
   strAdd.Format(_T("item string %d"), i);
   m_pComboBox->AddString(strAdd);
}