Das Element <tree> dient der Darstellung von Projektkomponenten in einer Baumstruktur. Die Wurzel des Baums wird mit dem Attribut root und die anzuzeigenden Äste mit dem Unterelement <treeNode> angegeben. Die Darstellung erlaubt außerdem die Definition von Hintergrundfarbe, Vordergrundfarbe, horizontaler, wie vertikaler Ausdehnung und Sichtbarkeit (siehe treeNode).
Außerdem können die Namen der Projektkomponenten manipuliert, sowie mit Symbolen ergänzt werden.
Wird das neue Element <treeNotification> mit dem Unterelement <onClickEvent> eingesetzt, lassen sich über die angezeigten Projektkomponenten Aktionen ausführen. (siehe treeNotifications und onClickEvent).
Attributname | Verwendung | Attributwerte | Defaultwert | Beschreibung |
---|---|---|---|---|
bColor | optional | 0,0,0 bis 255,255,255 | Systemfarbe | Hintergrundfarbe als RGB-Wert |
fColor | optional | 0,0,0 bis 255,255,255 | Systemfarbe | Vordergrundfarbe als RGB-Wert |
hSize | optional | Breite des Elements EEC = Breite in Zeichen Web-Applikation = Breite in Pixel |
||
root | benötigt | Die angegebene Formel muss eine Projektkomponente liefern, die als Wurzel der Baumstruktur dient. | ||
visible | optional | true, false | true | true = Tabelle ist sichtbar false = Tabelle ist unsichtbar |
vSize | optional | Höhe des Elements EEC = Höhe in Zeichen Web-Applikation = Höhe in Pixel |
Erlaubte Unterelemente | Anzahl |
---|---|
treeNode | 0..1 |
treeNotifications | 0..1 |
Baumstruktur mit Symbolen vor jeder Projektkomponente:
Das folgende Beispiel zeigt eine Baumstruktur, bei der vor jeder Projektkomponente in Abhängigkeit eines Parameterwerts ein unterschiedliches Symbol angezeigt wird.
<form title="project tree" id="projectTree">
<tree root="=ref('Documentation_UI_Configuration.Mechatronic.Documentation')">
<treeNode name="='Node: '+ node.name"
icon="= if ($found = true)
then type('Documentation_UI_Configuration.ProjectLibrary.
HelpObjects.Images.action').image
else type('Documentation_UI_Configuration.ProjectLibrary.
HelpObjects.Images.next_class').image endif"
children="=node.mos.flatten" />
</tree>
</form>
Ergebnis:
Baumstruktur mit Symbolen vor jeder Projektkomponente, die durch Anklicken eine Aktion auslöst:
Das folgende Beispiel zeigt eine Baumstruktur, bei der vor jeder Projektkomponente in Abhängigkeit eines Parameterwerts ein unterschiedliches Symbol angezeigt wird. Die Projektkomponenten haben einen Parameterwert gespeichert, mit dem per Aktion ein anzuzeigender Wert berechnet wird. Um die Aktion auszulösen ist eine Projektkomponente in der Baumstruktur anzuklicken.
<form title="project tree with action" id="projectTreeAction">
<tree root="=ref('Documentation_UI_Configuration.Mechatronic.Documentation')">
<treeNode name="='Node: '+ node.name"
icon="= if ($found = true)
then type('Documentation_UI_Configuration.ProjectLibrary.
HelpObjects.Images.action').image
else type('Documentation_UI_Configuration.ProjectLibrary.
HelpObjects.Images.next_class').image endif"
children="=node.mos.flatten" />
<treeNotifications>
<onClickEvent>
<performEvent name="Documentation_UI_Configuration.ProjectLibrary.
HelpObjects.CalculateCoordinateAction"
arguments="=List{node.$Coordinate, this}" />
</onClickEvent>
</treeNotifications>
</tree>
<line>
<label text="='Calculated cardinal point: '"></label>
<label text="=$CardinalPoints"></label>
</line>
</form>
Ergebnis: