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

Latest revision as of 14:52, 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 widget displays a frame that can organize one or more other widgets.

Group Box: A Group Box widget displays a frame with a title text on top and can organize one or more other widgets.

Tab Widget: A Tab Widget provides a tab bar and a page area used to display pages related to each tab. The tab bar is typically shown above the page area, with each tab corresponding to a different page. Only the current page is visible in the page area, while all other pages are hidden. The user can display a different page by clicking its tab.

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

Web Browser: A Web Browser widget is a container for a web page, which can be read-only, local, or internet-based, and allows browsing. The web page address can be stored in a database table field.

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 user clicks on a button.

@@ Line 1: / Line 1: @@
 <languages/>
 <translate>
-===The Form Design Tab=== <!--T:1-->
+===The Form Design Toolbar=== <!--T:1-->
 <!--T:2-->
-[[Image:kexi_form_design_tab.png|center]]
+[[Image:kexi_form_design_tab.png|800px|center]]
 <!--T:3-->
-From the <menuchoice>Form Design</menuchoice> tab you can you select widgets to add to your form.
+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.
 <!--T:4-->
 ; <menuchoice>Pointer</menuchoice>
-: <menuchoice>Pointer</menuchoice>, switches to the widget selection mode.
+: <menuchoice>Pointer</menuchoice> 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''.
-<!--T:5-->
-{{Note|Selecting any widget, will switch to the widget add mode. Then you can click anywhere on the form to place the widget.}}
 <!--T:6-->
 ; <menuchoice>Label</menuchoice>
-: A <menuchoice>Label</menuchoice> widget displays predefined information on a form. Usually it is used as a caption next to other data-aware widgets.
+: A <menuchoice>Label</menuchoice> widget displays textual information on a form. It is typically used as a label next to a data-aware widget.
-<!--T:7-->
-; <menuchoice>Image Box</menuchoice>
-: An <menuchoice>Image Box</menuchoice> holds an image, bound to a field in a table.
 <!--T:8-->
 ; <menuchoice>Text Box</menuchoice>
-: A <menuchoice>Text Box</menuchoice> is a single line container for data contained in your table.
+: A <menuchoice>Text Box</menuchoice> widget is a single-line container that allows you to enter text, which can be saved to the database table.
 <!--T:9-->
 ; <menuchoice>Text Editor</menuchoice>
-: A <menuchoice>Text Editor</menuchoice> is a multiline container for data contained in your table.
+: A <menuchoice>Text Editor</menuchoice> widget is a multi-line container that allows you to enter text, which can be saved 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.
 <!--T:11-->
 ; <menuchoice>Combo Box</menuchoice>
-: A <menuchoice>Combo Box</menuchoice> displays a list of options to choose from.
+: A <menuchoice>Combo Box</menuchoice> 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.
 <!--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> 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:13-->
+<!--T:10-->
-; <menuchoice>Line</menuchoice>
+; <menuchoice>Button</menuchoice>
-: A <menuchoice>Line</menuchoice> is used as a logical separator between different parts of a form.
+: A <menuchoice>Button</menuchoice> allows the user to execute an action upon clicking.
 <!--T:14-->
 ; <menuchoice>Frame</menuchoice>
-: A <menuchoice>Frame</menuchoice> is used as a container for other widgets.
+: A <menuchoice>Frame</menuchoice> widget displays a frame that can organize one or more other widgets.
 <!--T:15-->
 ; <menuchoice>Group Box</menuchoice>
-: A <menuchoice>Group Box</menuchoice> is used to group other widgets and control their state.
+: A <menuchoice>Group Box</menuchoice> widget displays a frame with a title text on top and can organize one or more other widgets.
 <!--T:16-->
 ; <menuchoice>Tab Widget</menuchoice>
-: A <menuchoice>Tab Widget</menuchoice> is used as a container for other widgets and can have many pages that contain different widgets.
+: A <menuchoice>Tab Widget</menuchoice> provides a tab bar and a ''page area'' used to display pages related to each tab. The tab bar is typically shown above the page area, with each tab corresponding to a different page. Only the current page is visible in the page area, while all other pages are hidden. The user can display a different page by clicking its tab.
+<!--T:13-->
+; <menuchoice>Line</menuchoice>
+: A <menuchoice>Line</menuchoice> is used as a logical separator between different parts of a form.
 <!--T:17-->
-<!-- TODO
+; <menuchoice>Web Browser</menuchoice>
-; '''Web Browser'''
+: A <menuchoice>Web Browser</menuchoice> widget is a container for a web page, which can be read-only, local, or internet-based, and allows browsing. The web page address can be stored in a database table field.
-: A '''Web Browser''' is a widget that allows to display a web page inside the form.
--->
+<!--FIXME add a Map Browser when supported -->
-<!--FIXME missing Map Browser-->
+; <menuchoice>Slider</menuchoice>
+: 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> 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> 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> widget displays a date value and allows the user to select a different date and save it to the database table field.
 <!--T:18-->
 ; <menuchoice>Assign Action</menuchoice>
-: <menuchoice>Assign Action</menuchoice> is used to assign an action to be executed when an event occurs (e.g. clicking on a button).
+: <menuchoice>Assign Action</menuchoice> is used to assign an action to be executed when user clicks on a button.
 <!--T:19-->