Vcl.ComCtrls.TTreeNodes.AddNode

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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.

Siehe auch