System.Classes.TStrings.SetCapacity
Delphi
procedure SetCapacity(NewCapacity: Integer); virtual;
C++
virtual void __fastcall SetCapacity(int NewCapacity);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
procedure function |
protected | System.Classes.pas System.Classes.hpp |
System.Classes | TStrings |
Description
Change la quantité de mémoire allouée pour contenir les chaînes de la liste.
SetCapacity est l'implémentation en lecture protégée de la propriété Capacity.
NewCapacity est le nombre de chaînes que la liste peut contenir une fois que la capacité a changé.
Dans TStrings, SetCapacity ne fait rien. Les classes dérivées redéfinissent cette méthode pour qu'elle change le nombre de chaînes que la liste peut contenir.
Remarque : Pour les classes dérivées qui implémentent SetCapacity, l'affectation d'une valeur inférieure à Count supprime des chaînes à la fin de la liste. L'affectation d'une valeur supérieure à Count alloue de l'espace permettant d'ajouter des chaînes.