Subwidget

The appearance of subwidget component is fully configurable, since a subwidget is, indeed, a usual widget that's just inserted into another widget. This is what a subwidget component may look like:

The nested widget, represented by a subwidget component, can interact with its host widget:

• First, a widget that will act as a subwidget is created.
• Second, some custom properties are added to the root panel of this widget. These properties will be used as a "bridge" between a host widget and the subwidget.

Example: The root panel of "Conveyor" subwidget (pictured above) has boolean Processing property that starts/stop the conveyor belt.

• Third, the above custom properties are bound to some component properties inside the "nested" widget. For example, in the "Conveyor" subwidget

Example: The Processing property of the "Conveyor" subwidget is bound to Operate properties of several Vector Drawing components that constitute the conveyor belt inside the nested widget.

• Fourth, the host widget is created and a Subwidget component is added to it. The Subwidget component's Reference property is set up to point the "nested" widget. The Processing property of the nested widget will than appear as a regular property of Subwidget component inside the host widget.
• Fifth, "inherited" properties of a subwidget are bound to some component properties of a host widget. This finalizes building the widget-to-subwidget interactions.

Example: The Processing property of the "Conveyor" subwidget is bound Enabled property of "Main Switch" toggle button inside the host widget. Thus clicking this button to start/stop the whole bottling line will also start/stop the conveyor belt.

Please save changes of both widget and subwidget and reopen them in GUI Builder to see the result of widget and subwidget configuration.

Width, Height, Bindings, Visible, Border, Tooltip

Path of a widget context matching the widget to load and display inside this subwidget component.

Property name: reference

Property type: String

An expression that should return a string path of a context that will become default context for the nested widget. {.:} (or, equally, dc() ) expression will cause inheriting default context from the current widget.

Property name: defaultContext

Property type: String

Defines whether subwidget startup bindings should be executed after root panel execute all startup bindings.

Disabling this option causes startup subwidget bindings and root panel bindings to be processed in random order.

Property name: waitParentBindingsExecution

Property type: Boolean

The subwidget component exposes custom properties of referred widget's root panel as its own properties to allow interaction between the host widget and a the subwidget.

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

Was this page helpful?

Tell us more

Send

Thank you!