API:System.Classes.TStringList.SetCapacity

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure SetCapacity(NewCapacity: Integer); override;

C++

virtual void __fastcall SetCapacity(int NewCapacity);

Eigenschaften

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

Beschreibung

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

System.Classes.TStringList.SetCapacity erbt von System.Classes.TStrings.SetCapacity. Der folgende Inhalt bezieht sich auf System.Classes.TStrings.SetCapacity.

Ä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