System.Classes.TStrings.SetCapacity
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.