events

Typ: Array von JSON-Objekten
Erforderlich: Nein

"events": [
   {
      "name": ".onMyCustomEvent",
      "displayName": ".onMyCustomEvent",
      "visible": true,
      "displayPriority": 30,
      "category": "Control",
      "description": "This is a sample for a framework control event.",
      "heritable": true
      "allowsPreventDefault": false
   }
]

Diese Eigenschaft definiert Events, die über das Engineering konfiguriert werden können und in diesem Framework Control ausgelöst werden. Mit Hilfe eines Events wird dem Engineering mitgeteilt, dass ein bestimmtes Ereignis in dem Control eingetreten ist und der HMI-Entwickler im Engineering hat die Möglichkeit, entsprechend auf dieses Ereignis zu reagieren. Das Auslösen eines Events wird in der Source.js implementiert.

Ein Event-Objekt enthält folgende Eigenschaften:

• name {String}: Interner Name des Events.
• displayName {String}: Name der Funktion, der im Engineering angezeigt wird.
• visible {Boolean}: Sichtbarkeit des Events. Wird „visible“ auf „false“ gesetzt, wird das Event nicht im Engineering angezeigt.
• displayPriority {Number}, nicht erforderlich: Die Priorität legt die Reihenfolge der Anzeige der verschiedenen Events innerhalb der Kategorie fest.
• Werte = 10 entsprechen häufig benutzten Events wie z. B. „.onPressed“.
• Werte = 15 entsprechen Standard-Events wie z. B. „.onClick“ oder „onRightClick“.
• Werte = 50 entsprechen selten benutzen Events wie z. B. „.onMouseUp“.
• Kein Wert vergeben: Das Event wird standardmäßig eingeklappt und muss über den Pfeil ausgeklappt werden.
• category {String}: Die Kategorie legt fest, unter welcher Kategorie das Event im Engineering gelistet wird. Es können bereits vorhandene Kategorien wie z. B. „Operator“ verwendet werden, oder neue Kategorien-Name vergeben werden.
• description {String}: Optionale Beschreibung des Events, die im Engineering beim Mouseover als Tooltip angezeigt wird.
• heritable {Boolean}: Diese Eigenschaft definiert, ob das Event an abgeleitete Klassen vererbt werden soll. Per Default ist dieser Wert „true“, sodass das Event vererbt wird.
• allowsPreventDefault {Boolean}, nicht erforderlich: Diese Eigenschaft legt fest, dass ein Nutzer preventDefault explizit auswählen kann. Siehe auch Events

Das oben konfigurierte Event wird im Engineering wie folgt angezeigt: