Legend

Das Legend Control zeigt alle Icons auf der aktiven Webseite mit ihren Beschreibung an.

Verwendung

Einsatz auf jeder beliebigen Seite, auf der eine Erklärung der Icons angezeigt werden soll.

Features

Bietet eine statische und dynamische Anzeige der Icons und erlaubt das Hinzufügen zusätzlicher Icons.

Anzeige

Die Anzeige der Icons kann sowohl statisch auf der Webseite erfolgen als auch dynamisch (ereignisgesteuert) über den Aufruf der OpenLegendDialog-Funktion.

Legend 1:

Zusätzliche Icons

Lokal

Über das Attribut IconDataCustom können der jeweiligen Instanz der Legend weitere Icons hinzugefügt werden. Beim Funktionsaufruf befindet sich das Attribut in der Parameterliste.

Global

Icons, die von jeder Instanz der Legend anzuzeigen sind, müssen über ein TwinCAT HMI Internes Symbol hinzugefügt werden.

Das Symbol muss den Namen BaLegendIconDataList haben und vom Typ

TcHmi.BuildingAutomation.Controls.BuildingGeneral.Legend.IconDataList

sein.

Legend 2:

Attribute

Das Control erbt vom BaseControl und hat somit dieselben Attribute. Dazu kommen folgende Attribute.

Common

ShowHeadline

tchmi:general#/definitions/Boolean

Legt die Sichtbarkeit des Titels fest.

EntryWidth

tchmi:framework#/definitions/MeasurementValue

Breite eines Eintrags.

EntryWidthUnit

tchmi:framework#/definitions/MeasurementUnit

Einheit der Breite eines Eintrags.

TabPosition

tchmi:framework#/definitions/TcHmi.BuildingAutomation.Position

Position der Tabs.

IconDataSource

tchmi:framework#/definitions/TcHmi.BuildingAutomation.Controls.BuildingGeneral.Legend.IconDataSource

Auswahl anzuzeigender Einträge.

IconDataCustom

tchmi:framework#/definitions/TcHmi.BuildingAutomation.Controls.BuildingGeneral.Legend.IconDataList

Liste mit zusätzlichen Einträgen.