System.Classes.TStrings.SetCapacity

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure SetCapacity(NewCapacity: Integer); virtual;

C++

virtual void __fastcall SetCapacity(int NewCapacity);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
protected
System.Classes.pas
System.Classes.hpp
System.Classes TStrings

Beschreibung

Ändert die Größe der String-Liste.

SetCapacity ist die Schreibmethode der Eigenschaft Capacity.

NewCapacity legt die Anzahl der String-Einträge fest, die die Liste aufnehmen kann, nachdem ihre Größe geändert wurde.

In TStrings führt SetCapacity keine Aktion aus. Abgeleitete Klassen können diese Methode überschreiben, um die Anzahl der String-Einträge zu ändern, die die Liste aufnehmen kann.

Hinweis: Wenn der mit SetCapacity zugewiesene Wert kleiner ist als der Wert der Eigenschaft Count, werden String-Einträge am Ende der Liste entfernt. Ist der Wert größer als Count, wird Speicher für die zusätzlichen Strings reserviert.

Siehe auch