Vcl.Outline.TCustomOutline.InsertObject

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function InsertObject(Index: LongInt; const Text: string; const Data: TCustomData): LongInt;

C++

int __fastcall InsertObject(int Index, const System::UnicodeString Text, const void * Data);

Propriétés

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

Description

Insère noeud contenant des données à une position spécifiée.

InsertObject permet d'ajouter un objet TOutlineNode à l'arborescence et de lui affecter un pointeur de données. Text spécifie la valeur de la propriété Text du nouveau noeud. Data spécifie la valeur de la propriété Data 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.

Voir aussi