RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TComponentList.Remove Method

Removes a specified component from the list and (if OwnsObjects is true) frees the component.

Pascal
function Remove(AComponent: TComponent): Integer;
C++
__fastcall int Remove(TComponent * AComponent);

Call Remove to delete a specific component from the list when its index is unknown. The value returned is the index of the component in the Items array before it was removed. If the specified component is not found on the list, Remove returns –1. If OwnsObjects is true, Remove frees the component in addition to removing it from the list. 

After a component is deleted, all the components that follow it are moved up in index position and Count is decremented. If a component appears more than once on the list, Remove deletes only the first appearance. Hence, if OwnsObjects is true, removing a component that appears more than once results in empty references later in the list. 

To use an index position (rather than an object reference) to specify the component to be removed, call Delete

To remove a component from the list without freeing it, call Extract

 

Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!