API:System.Classes.TStringList.SetCapacity

提供:RAD Studio API Documentation

Delphi

procedure SetCapacity(NewCapacity: Integer); override;

C++

virtual void __fastcall SetCapacity(int NewCapacity);

プロパティ

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

説明

リスト内の文字列を保持するために割り当てられたメモリの量を変更します。 {{#multireplace:System.Classes.TStringList.SetCapacity|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} は {{#multireplace:System.Classes.TStrings.SetCapacity|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を継承しています。以下の内容はすべて {{#multireplace:System.Classes.TStrings.SetCapacity|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を参照しています。

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

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

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

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

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

関連項目