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);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Vcl.ComCtrls.pas Vcl.ComCtrls.hpp |
Vcl.ComCtrls | TTreeNodes |
Beschreibung
Fügt einen neuen Knoten in ein Baumdiagramm ein.
AddNode fügt ein Knotenobjekt in die Kollektion ein. AddNode gibt den neu hinzugefügten Knoten zurück und nimmt die folgenden Parameter entgegen:
Node bezeichnet das Knotenobjekt, das hinzugefügt werden soll. Wenn Node den Wert nil hat, wird die Methode CreateNode des Baumdiagramms aufgerufen, damit ein Wert bereitgestellt werden kann.
Die Parameter Relative und Method definieren zusammen die Position des neuen Knotens. Relative steht für einen vorhandenen Knoten, der dem neuen Knoten entweder über- oder gleichgeordnet ist. Method bestimmt die genaue Beziehung zwischen dem neuen Knoten und seinem Bezugsknoten. Maßgebend ist der Wert der Konstante TNodeAttachMode.
Der Parameter S legt den Wert der Eigenschaft Text des neuen Knotens fest.
Der Parameter Ptr legt den Wert der Eigenschaft Data des neuen Knotens fest.
Anmerkung: Der von Ptr referenzierte Speicher wird nicht freigegeben, wenn das TTreeNodes-Objekt freigegeben wird.