Vcl.ComCtrls.TTreeNodes.AddNode

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function AddNode(Node, Relative: TTreeNode; const S: string; Ptr: TCustomData; Method: TNodeAttachMode): TTreeNode;

C++

TTreeNode* __fastcall AddNode(TTreeNode* Node, TTreeNode* Relative, const System::UnicodeString S, void * Ptr, TNodeAttachMode Method);

Propriétés

Type Visibilité  Source Unité  Parent
function public
Vcl.ComCtrls.pas
Vcl.ComCtrls.hpp
Vcl.ComCtrls TTreeNodes

Description

Ajoute un noeud à une vue arborescente.

AddNode ajoute un objet noeud à la collection. AddNode renvoie le noeud qui vient d'être ajouté et attend les paramètres suivants :

Node est l'objet noeud à ajouter. Si Node vaut nil, la méthode CreateNode de la vue arborescente est appelée pour en fournir un.

Les paramètres Relative et Method définissent ensemble la position du nouveau noeud. Relative désigne un noeud existant qui sera soit le parent soit le frère du nouveau noeud. Method spécifie la relation exacte établie entre le nouveau noeud et celui désigné par Relative, comme définie par une constante TNodeAttachMode.

Le paramètre S spécifie la valeur de la propriété Text du nouveau noeud.

Le paramètre Ptr spécifie la valeur de la propriété Data du nouveau noeud.

Remarque :  La mémoire référencée par Ptr n'est pas libérée quand l'objet noeuds d'arborescence est libéré.

Voir aussi