Kexi/Handbook/Building Simple Databases/Designing Forms/Using the Widgets tab: Difference between revisions

Latest revision as of 20:24, 25 December 2024

Using the Widgets tab

The widgets tab in the Properties pane provides a tree list of widgets on the form design page and their hierarchy. Each widget is presented within the hierarchy beside other widgets on the same level (in the same parent container). Child widgets (inside containers) are presented using indented names.

Each widget has its name and type displayed. The type also shows an icon - the same as displayed on the Widgets toolbar.

Note

* Changing the current selection on the list is synchronised to the selection on the form design page. This allows for easier widget lookup by name and easier navigation. For example, it is possible to select a widget by name, and then switch to the Properties tab to change the widget's properties.

Keeping the Ctrl key pressed while an item on the widgets list is being selected allows to select multiple widgets at a time. Keeping the Shift key pressed allows to select entire lists of widgets.

Giving widgets reasonable names can be useful in complex forms but is not mandatory. Note that a widget's name is a property that is not visible to the user of your form. Users will only see a widget text, provided by Text property or similar.

@@ Line 4: / Line 4: @@
 <!--T:2-->
-The widgets tab {{Icon|action-widgets}} in the '''Properties''' pane provides a list of form widgets and their hierarchy. Each widget is presented within the hierarchy beside other widgets being on the same level (the same parent container). Child widgets (inside containers) are presented using indented names.
+The widgets tab in the '''Properties''' pane provides a tree list of widgets on the form design page and their hierarchy. Each widget is presented within the hierarchy beside other widgets on the same level (in the same parent container). Child widgets (inside containers) are presented using indented names.
 <!--T:3-->
-Each widget has displayed its name and type. The type has also an icon displayed - the same as the one displayed on the toolbar used while form designing is performed.
+Each widget has its name and type displayed. The type also shows an icon - the same as displayed on the Widgets toolbar.
 <!--T:4-->
@@ Line 13: / Line 13: @@
 <!--T:8-->
-* Changing the current selection on the list causes appropriate selection on the designed form. This allows for easier widget lookup by name and easier navigation. For example, it is possible to select a widget by name, and then switch to the <menuchoice>Properties</menuchoice> tab to change the widget's properties.
+* Changing the current selection on the list is synchronised to the selection on the form design page. This allows for easier widget lookup by name and easier navigation. For example, it is possible to select a widget by name, and then switch to the <menuchoice>Properties</menuchoice> tab to change the widget's properties.
 <!--T:9-->
@@ Line 19: / Line 19: @@
 <!--T:5-->
-Giving widgets reasonable names can be useful but is not mandatory. Note that widget's name is a property that is not visible to the user of your form. Users will only see a widget text, provided by '''Text''' property or similar.
+Giving widgets reasonable names can be useful in complex forms but is not mandatory. Note that a widget's name is a property that is not visible to the user of your form. Users will only see a widget text, provided by '''Text''' property or similar.
 <!--T:6-->