Root Panel

Root panel is a special type of Panel container that has several additional properties and events.

A Root Panel supports the following common widget component properties:

Width, Height, Bindings, Background, Opaque, Border, Cursor, Tooltip, Focusable, Popup Menu

And the following common container properties:

Layout, Scrolling, Smart Scrollbar Policy

This section describes properties of the root panel of the widget.

If this option is enabled, any binding errors that occur during widget execution are not shown to the user in error dialog. Instead, they are just written to the log file or console (see logging topic for more information). If this option is disabled (this is a default), bindings errors are both logged and shown to the user.

Property name: ignoreBindingErrors

Property type: Boolean

This property contains a list of all bindings available in the widget template. See the Bindings article for more information about bindings and their parameters.

Property name: allBindings

Property type: Data Table

This property contains the table of widget scripts. There are two columns: Name and Code.

Name is the script name. It it used to refer to this script from widget bindings.

Code contains text of a class implementing WidgetScript interface, i.e. script code.

When a new script is added to the scripts table, a new binding used to launch it is automatically added to the All Bindings list. However, initial properties of this binding do not define any script launch conditions. It's necessary to modify these properties to make the script start on widget startup, some event or just periodically.

Property name: scripts

Property type: Data Table

Defines the core size of widget's thread pool, i.e. base number of bindings that will be processed simultaneously.

Zero value disables parallel bindings processing.

See Binding Performance for more information.

This setting is ignored if a widget is used as a subwidget in another widget. Subwidgets inherit the thread pool of their parent widget.

Property name: normalConcurrentBindings

Property type: Integer

Defines the maximum size of widget's thread pool, i.e. the number of concurrently processed bindings allowed in case of binding queue overflow.

Zero value disables parallel bindings processing.

See Binding Performance for more information.

This setting is ignored if a widget is used as a subwidget in another widget. Subwidgets inherit the thread pool of their parent widget.

Property name: maximumConcurrentBindings

Property type: Integer

Defines how many unprocessed binding operations can be queued before widget's thread pool size grows over its core size towards maximum size.

See Binding Performance for more information.

This setting is ignored if a widget is used as a subwidget in another widget. Subwidgets inherit the thread pool of their parent widget.

Property name: maximumBindingQueueLength

Property type: Integer

Defines whether startup bindings can be executed in parallel threads.

Enabling this option causes startup bindings to be processed in random order.

Property name: startupBindingsConcurrency

Property type: Boolean

Settings in this group are related to touch panel support.

Defines what font is used to label native onscreen keyboard's buttons.

Property name: embeddedOnscreenKeyboardFontSize

Property type: Integer

The path of native onscreen keyboard application's executable file to launch when keyboard input is requested.

There are several pre-defined selections (despite any other file can be referred):

• None (forces use of Iotellect's own embedded onscreen keyboard)
• Windows Onscreen Keyboard (C:Windows/system32/osk.exe)
• GNOME Onboard (onboard)
• KDE Kvkbd (kvkbd)

Property name: nativeOnscreenKeyboardCommand

Property type: String

Root Panel has the following custom functions.

Allows to show the specified widget as a popup window.

Function name: showPopup

Allows to hide the current popup window.

Function name: hidePopup

This function has no input parameters.

Allows to execute context actions.

Function name: executeAction

Hidden, Shown, Moved, Resized, Mouse Clicked, Mouse Pressed, Mouse Released, Mouse Entered, Mouse Exited, Mouse Moved, Mouse Wheel Moved, Key Typed, Key Pressed, Key Released, Focus Gained, Focus Lost

This event may be triggered by a button having a Submit action in its actions list.

Event name: submit

This event may be triggered by a button having a Logout action in its actions list.

This event is a trigger to logout from current Widget Player, Web Widget Player or Web UI session. It returns user to login screen.

Event name: logout

This event may be triggered by a button having a Close action in its actions list.

Event name: close

Was this page helpful?

Tell us more

Send

Thank you!