CListBox::InitStorage

int InitStorage (int nItems, UINT nBytes );

Valeur de retour

Si réussie, le nombre maximal d'éléments que la zone de liste peut stocker avant une réallocation de mémoire est nécessaire, sinon LB_ERRSPACE, ce qui signifie pas assez de mémoire est disponible.

Paramètres

nItems

Spécifie le nombre d'éléments à ajouter.

nBytes

Spécifie la quantité de mémoire, en octets, à allouer pour les chaînes de l'élément.

Remarques

Alloue de la mémoire pour stocker les éléments de zone de liste. Appeler cette fonction avant d'ajouter un grand nombre d'éléments à une CListBox.

Cette fonction permet d'accélérer l'initialisation des zones de liste qui ont un grand nombre d'éléments (plus de 100). Il pré-alloue la quantité de mémoire spécifiée afin que les fonctions Dir , InsertStringet AddStringprennent les plus brefs délais. Vous pouvez utiliser des estimations pour les paramètres. Si vous surestimez, mémoire supplémentaire est allouée ; Si vous sous-estimez, la répartition normale est utilisée pour les éléments qui dépassent le montant préalloué.

Windows 95 uniquement : le paramètre nItems est limité aux valeurs 16 bits. Cela signifie que des zones de liste ne peut pas contenir plus de 32 767 articles. Bien que le nombre d'éléments est limité, la taille totale des éléments d'une zone de liste est limitée uniquement par la mémoire disponible.

Aperçu de CListBox |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CListBox::CListBox, CListBox::Create, CListBox::ResetContent, LB_INITSTORAGE

Index