System.Classes.TStrings.SetCapacity

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi