Kexi/Handbook/References/Toolbar Commands/The Form Design Toolbar: Difference between revisions

Revision as of 00:50, 25 December 2024

The Form Design Toolbar

From the Form Design toolbar, you can select widgets to add to your form. All widget items on the toolbar act as toggle buttons. Toggling a button switches to a mode that allows you to place a new widget anywhere on your form by clicking on the form's surface.

Pointer: Pointer switches to widget selection mode. In this mode, you can select any form widget by clicking it. You can then resize, move, delete, copy, or change its properties in the Property Editor.

Label: A Label widget displays textual information on a form. It is typically used as a label next to a data-aware widget.

Text Box: A Text Box widget is a single-line container that allows you to enter text, which can be saved to the database table.

Text Editor: A Text Editor widget is a multi-line container that allows you to enter text, which can be saved to the database table field.

Combo Box: A Combo Box widget displays a list of values for the user to choose from. The selected value or its index can then be saved to the database table field.

Check Box: A Check Box widget displays a Yes/No, True/False or Yes/Unknown/No value that can be saved to the database table field and allows you to select one of them.

Image Box: An Image Box widget is a container for an image, either read-only or allowing the user to select and save an image to the database table field.

Button: A Button allows the user to execute an action upon clicking.

Frame: A Frame is used as a container for other widgets.

Group Box: A Group Box is used to group other widgets and control their state.

Tab Widget: A Tab Widget is used as a container for other widgets and can have many pages that contain different widgets.

Line: A Line is used as a logical separator between different parts of a form.

Web Browser: A Web Browser is a widget that allows to display a web page inside the form.

Slider: A Slider widget displays a value from a minimum-maximum range and allows the user to select a different value from this range, and can be saved to the database table field.

Progress Bar: A Progress Bar widget displays feedback about the duration and progression of a process or task, indicating how long the user will be waiting. The value can be retrieved from the database table field.

Link Button: A Link Button allows the user to execute an action upon clicking, like a standard button, but can also display additional text.

Date Picker: A Date Picker widget displays a date value and allows the user to select a different date and save it to the database table field.

Assign Action: Assign Action is used to assign an action to be executed when an event occurs (e.g. clicking on a button).

@@ Line 31: / Line 31: @@
 <!--T:12-->
 ; <menuchoice>Check Box</menuchoice>
-: A <menuchoice>Check Box</menuchoice> holds two or three states of data (e.g. On/Off)
+: A <menuchoice>Check Box</menuchoice> widget displays a Yes/No, True/False or Yes/Unknown/No value that can be saved to the database table field and allows you to select one of them.
 <!--T:7-->
 ; <menuchoice>Image Box</menuchoice>
-: An <menuchoice>Image Box</menuchoice> holds an image, bound to a field in a table.
+: An <menuchoice>Image Box</menuchoice> widget is a container for an image, either read-only or allowing the user to select and save an image to the database table field.
 <!--T:10-->
 ; <menuchoice>Button</menuchoice>
-: A <menuchoice>Button</menuchoice> allows you to define actions to be executed upon clicking on it.
+: A <menuchoice>Button</menuchoice> allows the user to execute an action upon clicking.
 <!--T:14-->
@@ Line 61: / Line 61: @@
 : A '''Web Browser''' is a widget that allows to display a web page inside the form.
-<!--FIXME missing Map Browser-->
+<!--FIXME add a Map Browser when supported -->
 ; <menuchoice>Slider</menuchoice>
-: A <menuchoice>Slider</menuchoice> is used as a logical separator between different parts of a form.
+: A <menuchoice>Slider</menuchoice> widget displays a value from a minimum-maximum range and allows the user to select a different value from this range, and can be saved to the database table field.
 ; <menuchoice>Progress Bar</menuchoice>
-: A <menuchoice>Progress Bar</menuchoice> is used as a logical separator between different parts of a form.
+: A <menuchoice>Progress Bar</menuchoice> widget displays feedback about the duration and progression of a process or task, indicating how long the user will be waiting. The value can be retrieved from the database table field.
 ; <menuchoice>Link Button</menuchoice>
-: A <menuchoice>Link Button</menuchoice> is used as a logical separator between different parts of a form.
+: A <menuchoice>Link Button</menuchoice> allows the user to execute an action upon clicking, like a standard button, but can also display additional text.
 ; <menuchoice>Date Picker</menuchoice>
-: A <menuchoice>Date Picker</menuchoice> is used as a logical separator between different parts of a form.
+: A <menuchoice>Date Picker</menuchoice> widget displays a date value and allows the user to select a different date and save it to the database table field.
 <!--T:18-->