Tree-AddSibling

Funktionsname dcl-Tree-AddSibling
Syntax   (dcl-Tree-AddSibling <CONTROL> uSiblingItem [als Handle oder String] {doInsertBefore [als Boolean]} strLabel [als String] {strKey [als String]} {intImageIndex [als Integer]} {intSelectedImageIndex [als Integer]} {intExpandedImageIndex [als Integer]})
Rückgabewert Handle
Anwendbar auf Tree

Diese Methode fügt einen neuen Eintrag nach (bzw. vor) dem angegebenen Eintrag auf der gleichen Ebene ein. Hat das Argument doInsertBefore den Wert nil oder wird das Argument doInsertBefore ausgelassen, wird der einzufügende Eintrag nach dem angegebenen Eintrag eingefügt; hat das Argument doInsertBefore den Wert T, wird es vor dem angegebenen Eintrag eingefügt. Das Argument strLabel definiert die Bezeichnung des neuen Eintrags. Wird ein Schlüssel mit strKey angegeben, muss dieser eindeutig innerhalb dieser Instanz der Baumstruktur sein, um einen Eintrag eindeutig zu identifizieren. Die drei optionalen Argumente intImageIndex, intSelectedImageIndex und intExpandedImageIndex sind Bilder entsprechend der Bildliste des Steuerelements und visualisieren den normalen Zustand, den ausgewählten und aufgeklappten Zustand. Der Rückgabewert ist der eindeutige Zeiger des neuen Eintrags, ansonsten NIL.