Elements

An element is a clickable rectangle of the widget. Its rectangle is in widget units, from the top-left corner of the widget, exactly as in the WBP Designer.

Elements come from a layout component (written by the online editor) and from the Elements list of interactive_widget_component. Both can be used together.

KindsCopy Anchor Link

FieldsCopy Anchor Link

Every field has a default value: a layout only writes the fields you changed.

Choices and groupsCopy Anchor Link

Choices with the same Group form a group: selecting one deselects the others. An empty Group gathers all the choices without a group into one group, and all the tabs without a group into another.

If several choices of a group have StartOn, the first one starts selected.

Screens and tabsCopy Anchor Link

A widget can have several screens, like the pages of a menu. Only the elements of the active screen, and those with Screen set to 0, can be aimed at.

• A Tab with OpensScreen set to 2 opens screen 2 when it is clicked, and becomes the selected tab of its group.
• The game starts on the screen of the tab with StartOn, else of the first tab, else on the lowest Screen used.
• Your WBP shows the active screen through a Screen field (int) bound to the Active Widget Index of a WidgetSwitcher. The editor writes it when you tick Screen field. Screen 1 is index 1: leave index 0 empty, or make it a screen of its own.
• From Verse, SetScreen and GetScreen change and read the screen.

SlidersCopy Anchor Link

• Firing on a slider sets the value under the crosshair. Holding fire drags it: the value follows the crosshair, and the click is sent when fire is released.
• E, or the interact button, sets the value under the crosshair. Used without aiming at the slider (from a mobile prompt), it moves the slider one step up, and back to MinValue after MaxValue.
• One step is Step, or a tenth of the range when Step is 0.
• The value shown to players (the Text field) is a whole number when Step is 1 or more, else it has two decimals.

SteppersCopy Anchor Link

A stepper moves its Target slider by Steps steps per click (-1 goes down). While its slider is disabled, the slider does not move. In Verse, the click names the stepper, and the change names the slider: see Verse API.

Writing elements by handCopy Anchor Link

In the Details panel, add entries to Elements on interactive_widget_component and fill their fields. Or write a layout component yourself:

using { /Verse.org/SceneGraph }
using { /Verse.org/Simulation }
using { WorldUIKit }

my_panel_layout<public> := class<final_super>(component, interactive_layout):

    GetLayout<override>()<transacts>:interactive_layout_data =
        interactive_layout_data{Width := 1200.0, Height := 800.0, Elements := array{
            interactive_element{Name := "Buy", Kind := interactive_kind.Button, X := 40.0, Y := 600.0, Width := 300.0, Height := 90.0, Prompt := "Buy"},
            interactive_element{Name := "Music", Kind := interactive_kind.Toggle, X := 40.0, Y := 100.0, Width := 300.0, Height := 60.0, StartOn := true}}}

When WidgetWidth and WidgetHeight are 0, the widget size comes from the layout; without a layout, from the elements (their bounding box plus 40 units).

Elements written by hand are clickable, but they write no field: your widget shows no hover and no state. To show them, generate the layout with the online editor, or implement interactive_fields in your layout component (Verse API).