System.Contnrs.TObjectList.Remove
Delphi
function Remove(AObject: TObject): Integer; overload; inline;
C++
HIDESBASE int __fastcall Remove(System::TObject* AObject)/* overload */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | System.Contnrs.pas System.Contnrs.hpp |
System.Contnrs | TObjectList |
説明
Remove は,指定されたオブジェクトをリストから削除し,(OwnsObjects が true の場合)オブジェクトを解放します。
Remove を呼び出すと,インデックスが不明なオブジェクトをリストから削除できます。返される値は,オブジェクトが削除される前の,Items 配列内のオブジェクトのインデックスです。指定したオブジェクトがリストに見つからない場合,Remove は -1 を返します。OwnsObjects が true の場合,Remove は,オブジェクトをリストから削除したうえで解放します。
オブジェクトを削除すると,削除されたオブジェクトに続くすべてのオブジェクトが上のインデックスに移動し,Count がデクリメントされます。リストに複数のオブジェクトが存在する場合,Remove は最初に見つかったオブジェクトだけを削除します。したがって,OwnsObjects が true の場合,複数回現れるオブジェクトを削除すると,リストのそれ以降に空のオブジェクト参照が発生します。
(オブジェクト参照ではなく)インデックスを使って削除するオブジェクトを指定するには,Delete を呼び出します。
オブジェクトを解放せずにリストから削除するには,Extract を呼び出します。