Vcl.Outline.TCustomOutline.Insert

Aller au parent : TCustomOutline

Delphi

function Insert(Index: LongInt; const Text: string): LongInt;

C++

HIDESBASE int __fastcall Insert(int Index, const System::UnicodeString Text);

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	Vcl.Outline.pas Vcl.Outline.hpp	Vcl.Outline	TCustomOutline

Description

Insert insère un noeud à un emplacement spécifié.

Insert permet d'ajouter un objet TOutlineNode à l'arborescence. Text spécifie la valeur de la propriété Text du nouveau noeud.

Index indique l'endroit où le nouveau noeud doit être ajouté. Le nouveau noeud est positionné dans l'arborescence à l'emplacement actuellement occupé par le noeud identifié par Index. Le nouveau noeud est inséré au même niveau que le noeud actuellement identifié par Index, afin que le noeud original et le nouveau noeud soient frères et partagent le même parent. Pour ajouter des noeuds au début de l'arborescence, spécifiez la valeur zéro (0) pour le paramètre Index.

Les noeuds qui apparaissent après le nouveau noeud, dont celui spécifié par Index avant qu'Insert soit appelée, sont descendus d'une ligne et réindexés dans le tableau de propriété Items avec les valeurs Index correctes. Si BeginUpdate a été appelée, le tableau Items n'est pas réindexé tant que la méthode EndUpdate n'a pas été appelée.

Insert renvoie la propriété Index du nouveau noeud.