System.Classes.TStrings.SetCapacity

Delphi

procedure SetCapacity(NewCapacity: Integer); virtual;

C++

virtual void __fastcall SetCapacity(int NewCapacity);

種類	可視性	ソース	ユニット	親
procedure function	protected	System.Classes.pas System.Classes.hpp	System.Classes	TStrings

説明

リスト内の文字列を保持するために割り当てられたメモリの量を変更します。

SetCapacity メソッドは，Capacity プロパティの，プロテクトされた読み出し専用の実装です。

NewCapacity は，容量の変更後にリストで保持できる文字列の数です。

TStrings では，SetCapacity は何もしません。下位オブジェクトはこのメソッドをオーバーライドして，リストで保持できる文字列の数を変更します。

注意：SetCapacity メソッドを実装する下位クラスの場合は，Count プロパティより小さい値を割り当てると，リストの最後から文字列が削除され，Count プロパティより大きい値を割り当てると，追加される文字列用に容量が割り当てられます。