Editing GUI

 
Once you have created the GUI object you are able to populate your GUI by adding Widget Objects:
 
  • Click on the Edit Widgets combobox droplist button
  • Select Add widget from the droplist
 
 
When you create a Widget object, the created widget is immediately selected.
When a widget is selected an orange border will appear around the widget in the GUI viewport, and its parameters will appear into the Class Properties tool.
3.4.6.2. Editing GUI
1

Selected Widget

1. Selected Widget
An orange box appears at the borders of the selected widget
2

Widget Properties

2. Widget Properties
 
The properties of the selected widget can be edited here.
 
CLASSIFY A WIDGET
When you create a new Widget Object a default Button widget is assigned to it. You can change the widget class by clicking on the WidgetClass parameter in the General section of the Widget Object class properties, as showed into the following image:
 
A new dialog will appear, containing all the classes available in S2ENGINE HD:
3.4.6.2. Editing GUI
1

Class Filter

1. Class Filter
Click here to open the droplist of class filters:
And select Widgets for showing ONLY widget related classes
2

Class List

2. Class List
The list of all classes filtered. Click an item to select the class you want.
3

Search for a class

3. Search for a class
Type here if you already know the name or part of the name of the class you want, the system will automatically show, in the class list, only classes containing the searching word in their name
 
Once you have selected, in the class list, the widget class you want to give to the widget object you can click on OK button to apply. The widget object will be automatically converted into the desired widget class and it also will change its icon in the GUI Widgets tool.
 
WIDGETS HIERARCHY
Widgets can be organized in hierarchies by putting them inside special kind of widgets called Frames.
Frames are the most basic type of Container widget.
 
To Create a frame you have to simply create a widget and then assign it a Frame class in a way as described previously.
 
Once you have created a frame you can put inside it other widgets.

A frame can contain other frames.

 
To put a widget inside a frame you have to first create the widget, then you have 2 possibilities:
 
  • Drag 'n' drop the widget item on the frame item in the  GUI Widgets tool, as showed into the following image
     
  • Use the parent parameter into the class properties of the widget.
  • Click on the void button
  • The Select Widget Dialog will appear
    3.4.6.2. Editing GUI
    1

    Source Widgets list

    1. Source Widgets list
    The list from which to select the widget. Select the frame widget here
    2

    Selection list

    2. Selection list
    The list containing all the successfully selected widgets. If the frame selection goes well the frame widget will appear here.
    3

    Select / Deselect arrows

    3. Select / Deselect arrows
    When you select a widget from the source list you have to click the right-to-left arrow to move the widget into the selection list. Once did this, the widget is considered selected.
    If you want to remove the widget from selection list, simply click the left-to-right arrow
    4

    Search tool

    4. Search tool
    Type here the name of the widget for easly filter the list
    5

    Apply

    5. Apply
    Click here when you have done
     
For a complete description of the parameters of the Widget Object see the Widget Object paragraph.