Vcl.Outline.TCustomOutline.InsertObject

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

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

C++

int __fastcall InsertObject(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 an der angegebenen Position einen Knoten ein, der Daten enthält.

Verwenden Sie InsertObject, 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 an der Position eingefügt, die von dem durch Index angegebenen Knoten eingenommen wird. Der neue Knoten wird also auf derselben Hierarchiestufe eingefügt wie der ursprüngliche Knoten, ist dem ursprünglichen Knoten gleichgeordnet und beide Knoten besitzen dasselbe übergeordnete Element. Soll ein Knoten an den Anfang gesetzt werden, geben Sie für den Parameter Index null (0) an.

Alle nach dem eingefügten Knoten werden um eine Position verschoben 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.

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

Siehe auch