Vcl.Outline.TCustomOutline.Insert

Übergeordnet: TCustomOutline

Delphi

function Insert(Index: LongInt; const Text: string): LongInt;

C++

HIDESBASE int __fastcall Insert(int Index, const System::UnicodeString Text);

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 in die Gliederung ein.

Verwenden Sie Insert, um ein TOutlineNode-Objekt in die Gliederung einzufügen. Text legt den Wert der Eigenschaft Text 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.