Kexi/Handbook/Building Simple Databases/Designing Forms/Actions: Difference between revisions
m (fix formatting) |
(Merging Burkhards fixes to k.d.o version) |
||
Line 7: | Line 7: | ||
<!--T:3--> | <!--T:3--> | ||
Assigning actions to form buttons | |||
<!--T:4--> | <!--T:4--> | ||
Line 16: | Line 16: | ||
<!--T:6--> | <!--T:6--> | ||
# Switch to form's '''Design | # Switch to form's '''Design''' view if you have not done yet.</translate> | ||
<translate> | <translate> | ||
<!--T:11--> | <!--T:11--> | ||
Line 28: | Line 28: | ||
<translate> | <translate> | ||
<!--T:14--> | <!--T:14--> | ||
# An '''Assigning Action to | # An '''Assigning Action to Button''' dialog window will appear presenting a list of available actions. One of the actions is selected if the widget already has action assigned. Otherwise the '''Action category''' list has the <menuchoice>No action</menuchoice> item selected. </translate> | ||
<translate> | <translate> | ||
<!--T:15--> | <!--T:15--> | ||
# From the '''Action type''' | # From the '''Action type''' list select <menuchoice>Application actions</menuchoice> item. Available application-wide actions will be listed. </translate> | ||
<translate> | <translate> | ||
<!--T:16--> | <!--T:16--> | ||
# Select one of the actions on the list (e.g. <menuchoice>Delete | # Select one of the actions on the list (e.g. <menuchoice>Delete Selected object</menuchoice>).</translate> | ||
<translate> | <translate> | ||
<!--dialog closes immediately after clicking an action in the list | |||
<!--T:17--> | <!--T:17--> | ||
# Click the <menuchoice>OK</menuchoice> button or press the <keycap>Enter</keycap> key to accept your selection. | # Click the <menuchoice>OK</menuchoice> button or press the <keycap>Enter</keycap> key to accept your selection. --> | ||
<!--T:7--> | <!--T:7--> | ||
After switching to the form's data view you can try whether the action works. For example, if you assigned <menuchoice>Delete Row</menuchoice> action, clicking the button, the current database row will be deleted, similarly to executing <menuchoice>Edit->Delete Row</menuchoice> (<keycap>Ctrl+Delete</keycap>) menu command (depending on your settings you may be asked to confirm the removal). | After switching to the form's data view you can try whether the action works. <!--FIXME not in master/2.4 For example, if you assigned <menuchoice>Delete Row</menuchoice> action, clicking the button, the current database row will be deleted, similarly to executing <menuchoice>Edit->Delete Row</menuchoice> (<keycap>Ctrl+Delete</keycap>) menu command (depending on your settings you may be asked to confirm the removal). --> | ||
<!--T:8--> | <!--T:8--> | ||
{{Note| | {{Note| | ||
* To remove an action assignment, select <menuchoice>No | * To remove an action assignment, select the <menuchoice>No action</menuchoice> item from the '''Action category''' list of the '''Assigning Action to Button''' dialog window. <!--}}--> | ||
<!--T:18--> | <!--T:18--> | ||
* Actions only work in the form's data view. Not every action's assignment is reasonable. For example, the <menuchoice>Font...</menuchoice> action is available in data view, but only if you have a widget selected in the '''Design | * Actions only work in the form's data view. Not every action's assignment is reasonable. For example, the <!--FIXME in master/2.4 no Font action available???--><menuchoice>Font...</menuchoice> action is available in data view, but only if you have a widget selected in the '''Design''' view. If you make changes to the font settings the changes are applied to the text of that selected widget.}} <!--{{--> | ||
<!--T:9--> | <!--T:9--> |
Revision as of 15:42, 7 April 2012
Actions
An Action is a single activity isolated in the application, available for the user to execute. It can also be executed automatically as a reaction for a given event (e.g. after opening a form).
Assigning actions to form buttons
Many actions can be assigned to form button. The assigned action is executed after button is clicked.
To assign action:
- Switch to form's Design view if you have not done yet.
- Select the existing button widget by clicking on it or put a new button widget onto the form. If you inserted a new button, enter its title and press Enter key.
- Click the button widget with the right mouse button to display the context menu.
- From the context menu select command.
- An Assigning Action to Button dialog window will appear presenting a list of available actions. One of the actions is selected if the widget already has action assigned. Otherwise the Action category list has the item selected.
- From the Action type list select item. Available application-wide actions will be listed.
- Select one of the actions on the list (e.g. ).
After switching to the form's data view you can try whether the action works.
Note
* To remove an action assignment, select the
item from the Action category list of the Assigning Action to Button dialog window.
- Actions only work in the form's data view. Not every action's assignment is reasonable. For example, the action is available in data view, but only if you have a widget selected in the Design view. If you make changes to the font settings the changes are applied to the text of that selected widget.