TreeSelControl

Das TreeSelControl dient der Darstellung von Baumattributen, bei denen mehrere Werte ausgewählt werden können (multiple Baumattribute).

Beispiel für ein TreeSelControl:



Die Abbildung zeigt die Schlagwortauswahl im Suchdialog für Vorgänge. Im unteren Abschnitt wird die Baumstruktur angezeigt und im Auswahlfeld im oberen Abschnitt werden die ausgewählten Werte angezeigt.

Eigenschaften

Neben den Standard-Eigenschaften hat dieses Control die folgenden Eigenschaften:
Anmerkung: Das TreeSelControl verfügt nicht über die Eigenschaft ToolTipp, weil diese Hinweistexte bereits für die Erklärungen der Schaltflächen in der Symbolleiste des Controls verwendet werden.

FullPath

Diese Eigenschaft bestimmt, ob die ausgewählten Werte des Baumattributs im Auswahlfeld mit dem kompletten Pfadnamen angezeigt werden, also z. B. „Hardware.Drucker“ (bei „Hardware“ als übergeordnetem Knoten zu „Drucker“).

Typ Boolean
Werte True = Der komplette Pfadname wird angezeigt.

False = Der komplette Pfadname wird nicht angezeigt.

Diese Einstellung kann auch durch die Schaltfläche mit dem „i“ in der Symbolleiste des TreeSelControls gesetzt werden.



InsertRoot

Diese Eigenschaft bestimmt, ob das Stammelement, also das oberste Element der Hierarchie, über das jede Baumstruktur verfügt, als auswählbarer Wert angezeigt wird.

Typ Boolean
Werte True = Das Stammobjekt wird als Wert angezeigt.

False = Das Stammobjekt wird nicht als Wert angezeigt.

ListHeight

Diese Eigenschaft bestimmt die Höhe des Auswahlfelds, in dem die ausgewählten Werte angezeigt werden.

Typ Zahl
Werte Natürliche Zahl (Pixelangabe)

Die Zahl muss zwischen 0 und der Zahl, die in der Eigenschaft "Height" die Höhe des gesamten Controls angibt.

Orientation

Diese Eigenschaft bestimmt, ob das Feld mit der Baumstruktur und das Auswahlfeld nebeneinander oder untereinander angeordnet werden.

Typ Auswahlliste
Werte Horizontal = Die Felder werden nebeneinander angeordnet.

Vertical = Die Felder werden untereinander angeordnet.
Wichtig: Wenn Sie den Wert „Vertical“ setzen, bestimmt die Eigenschaft „ListHeight“ die Breite der Liste:



Anmerkung: Die Trennlinie zwischen den beiden Feldern kann später im ClassicDesk mit der Maus verschoben werden.

ShowToolbar

Diese Eigenschaft bestimmt, ob die Schaltflächen zum Zuordnen und Entfernen der Werte in der Symbolleiste des TreeSelControl angezeigt werden oder nicht.

Typ Boolean
Werte True = Die Schaltflächen werden angezeigt.

False = Die Schaltflächen werden nicht angezeigt.

Wenn die Schaltflächen nicht angezeigt werden, kann der Agent die Werte zuordnen, indem er sie mit der Maus in das Auswahlfeld zieht.
Anmerkung: Im Serviceware Processes werden die Schaltflächen immer angezeigt. Daher ist diese Eigenschaft im Web ohne Funktion.

ShowTree

Diese Eigenschaft bestimmt, ob das Feld mit der Baumstruktur angezeigt wird.

Typ Boolean
Werte True = Das Feld mit der Baumstruktur wird angezeigt.

False = Das Feld mit der Baumstruktur wird nicht angezeigt.
Wichtig: Diese Eigenschaft hat nur dann eine Funktion, wenn für die Eigenschaft "ShowToolbar" der Wert "True" gesetzt ist.

Methoden

GetCount

Diese Methode ermittelt die Anzahl der ausgewählten Werte.

Syntax GetCount
Parameter keine
Rückgabewert Zahl: Anzahl der ausgewählten Werte
Beispiel Die Anzahl der im Schlagwortbaum ausgewählten Werte soll in einem Nachrichtenfenster ausgegeben werden:

Dim entrycount

entrycount = TreeSelControlKeyword.GetCount

MsgBox entrycount

GetItem

Diese Methode ermittelt den Wert, der sich in der Auswahlliste an der angegebnen Position befindet.

Syntax GetItem(Index)
Parameter Index: Index der Position des zu ermittelnden Werts. Der Index ist nullbasiert, d.h der erste Eintrag hat den Index 0, der zweite den Index 1 usw.
Rückgabewert Wert der angegebenen Position als Objekt
Beispiel Der Wert, der in der Auswahlliste an dritter Stelle angezeigt wird, soll in einem Nachrichtenfenster ausgegeben werden:

Set entry = TreeSelControlKeyword.GetItem(2)

MsgBox entry.getname(1031)

SelectTreeItem

Diese Methode trägt den angegebenen Wert aus dem Baum in die Auswahlliste ein. Der Wert wird als IContent-Automation-Objekt zurückgegeben.

Syntax SelectTreeItem(Item)
Parameter Item: ID oder Anzeigename des Werts, der aus der Baumstruktur in das Auswahlfeld übernommen werden soll.
Rückgabewert Wert der angegeben Position als Objekt.
Beispiel Der Eintrag „software.pmcs.helpline.server“ mit der ID 100123 soll ausgewählt werden:

TS1.SelectTreeItem „software.pmcs.helpline.server“

TS1.SelectTreeItem 100123

Tastenkombinationen

Für das TreeSelControl stehen die folgenden Tastenkombinationen zur Verfügung:

NACH UNTEN Springt Sie zum nächsten Eintrag in der Baumstruktur oder verschiebt die Trennlinie zwischen Auswahlfeld und Baumstruktur nach unten, wenn diese markiert wurde (mit TAB bzw. Strg + TAB).
NACH OBEN Springt zum vorherigen Eintrag in der Baumstruktur oder verschiebt die Trennlinie zwischen Auswahlfeld und Baumstruktur oben, wenn diese markiert wurde (mit TAB bzw. Strg + TAB).
NACH RECHTS Öffnet einen geschlossenen Unterbaum.
NACH LINKS Schließt einen geöffneten Unterbaum.
Einfg Fügt den ausgewählten Wert in das Auswahlfeld ein.
Entf Löscht den ausgewählten Wert aus dem Auswahlfeld.
TAB Setzt den Fokus in das nächste Element innerhalb des Controls.
Strg + TAB Setzt den Fokus in das vorherige Element innerhalb des Controls.