System.Generics.Collections.TList.InsertRange

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure InsertRange(Index: Integer; const Values: array of T; Count: Integer); overload;
procedure InsertRange(Index: Integer; const Values: array of T); overload;
procedure InsertRange(Index: Integer; const Collection: IEnumerable<T>); overload;
procedure InsertRange(Index: Integer; const Collection: TEnumerable<T>); overload;

C++

void __fastcall InsertRange(int Index, const T *Values, const int Values_High, int Count)/* overload */;
void __fastcall InsertRange(int Index, const T *Values, const int Values_High)/* overload */;
void __fastcall InsertRange(int Index, const System::DelphiInterface<System::IEnumerable__1<T> > Collection)/* overload */;
void __fastcall InsertRange(int Index, TEnumerable__1<T>* const Collection)/* overload */;

Properties

Type Visibility Source Unit Parent
procedure
function
public
System.Generics.Collections.pas
System.Generics.Collections.hpp
System.Generics.Collections TList

Description

Insert collection into list.

InsertRange inserts an array of values Values into the list at the index Index. If the list Count plus the extra entries is greater than Capacity, Capacity is increased.

If Index is not valid for the list, an EArgumentOutOfRangeException exception is raised.

This is an O(n + m) operation, where n is the number of items in the list and m is the number of entries in Values.

An OnNotify event occurs indicating items were inserted in the list.

See Also

Code Examples