Tree-AddChild| Funktionsname | dcl-Tree-AddChild |
|---|---|
| Syntax | (dcl-Tree-AddChild
<CONTROL> (Liste von Listen in der Form (uParentItem [als Handle oder
String]
strLabel [als
String] {strKey [als String]}
{intImageIndex [als Integer]}
{intSelectedImageIndex [als Integer]}
{intExpandedImageIndex [als Integer]}) ...)) |
| Rückgabewert | Handle oder Boolean (T, wenn erfolgreich, ansonsten NIL) |
| Anwendbar auf | Tree |
Diese Methode fügt ein oder mehrere neue untergeordnete Einträge unterhalb eines übergeordneten Eintrags hinzu. Das Argument strLabel definiert die Bezeichnung des 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, wenn nur ein Eintrag hingefügt wurde. Wurden mehrere Einträge hinzugefügt, gibt die Methode den Wert T zurück, wenn der Vorgang erfolgreich war, ansonsten NIL.
Diese Methode kann sowohl für mehrere Einträge gleichzeitig aber auch für nur einen einzelnen Eintrag aufgerufen werden. Im letzteren Fall müssen die Argument nicht in verschachtelten Listen übergeben werden.