Events

The framework fires many events at different times. These can be used graphically or via JavaScript code (TcHmi.EventProvider.register).

Each control has many events, which are documented under the control (see Base Control, for example). The system also provides a series of events:

Name

Description

onConfigChanged

Available from version 1.12

There was a change in the tchmiconfig.json file. This can only occur during engineering.

onInitialized

Available from version 1.8

At this point, the system is initialized and the main control (view) was loaded. Other controls may not be loaded or visible at this time.

onLocaleChanged

Available from version 1.8

The language of the current display has been set or changed.

onThemeDataChanged

Available from version 1.10

The theme system has new values or CSS styles. In addition, this event is fired when a new font is loaded. This can happen at any time for characters that have never been displayed on the screen before.

onUserChanged

Available from version 1.12

A new user has been logged in.

onUserDataChanged

Available from version 1.12

A new user has been logged in and / or the configuration (time zone, ...) of the current user is now known to the system or has changed.

onUserInGroupChanged

Available from version 1.8

The system now knows or has changed the group membership of the current user.

onWebSocketOpened

Available from version 1.8

The communication to the server was successfully established.

onWebSocketClosed

Available from version 1.8

The communication to the server was interrupted. In normal operation, the connection is automatically restored.