Vcl.ComCtrls.TTreeNodes.AddNode
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é.