Vcl.Outline.TCustomOutline.AddChildObject

Übergeordnet: TCustomOutline

Delphi

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

C++

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

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	Vcl.Outline.pas Vcl.Outline.hpp	Vcl.Outline	TCustomOutline

Beschreibung

Fügt dem Knoten der Gliederung einen untergeordneten Knoten hinzu, der Daten enthält.

Verwenden Sie AddChildObject, um einem Knoten der Gliederung ein TOutlineNode-Objekt als untergeordneten Knoten hinzuzufügen und ihm einen Zeiger auf Daten zuzuweisen. Text legt den Wert der Eigenschaft Text des neuen Knotens fest. Data legt den Wert der Eigenschaft Data des neuen Knotens fest.

Index gibt an, wo der neue Knoten eingefügt werden soll. Der neue Knoten wird in der Gliederung als unmittelbar untergeordnetes Element des Knotens positioniert, der durch Index bezeichnet wird. Soll ein Knoten an die oberste Hierarchiestufe der Gliederung (dem Wurzelelement direkt untergeordnet) gesetzt werden, geben Sie für den Parameter Index null (0) an.

Knoten, die in der Gliederungshierarchie nach dem neuen Knoten angeordnet sind, werden um eine Hierarchiestufe nach unten versetzt und das Eigenschaftsarray Items wird mit neuen gültigen Index-Werten reindiziert. Wurde BeginUpdate aufgerufen, wird das Array Items erst dann neu indiziert, wenn die Methode EndUpdate aufgerufen wird.

AddChildObject gibt die Eigenschaft Index des neuen Knotens zurück.