System.Classes.TList.Insert

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure Insert(Index: Integer; Item: Pointer);

C++

void __fastcall Insert(int Index, void * Item);

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
System.Classes.pas
System.Classes.hpp
System.Classes TList

Description

Insère un objet dans le tableau Items à la position spécifiée par Index.

La méthode Insert permet d'insérer Item à l'intérieur du tableau Items. Le paramètre Index est un indice de base zéro, donc le premier élément du tableau a l'indice 0. Insert insère l'élément à la position indiquée et décale vers le bas l'élément occupant préalablement l'emplacement ainsi que tous ceux le suivant. Insert incrémente Count et, si nécessaire, alloue de la mémoire en augmentant la valeur de Capacity.

Pour remplacer un pointeur nil (Delphi) ou NULL (C++) du tableau par un nouvel élément, sans agrandir le tableau Items, voir la propriété Items.

Voir aussi