Kexi/Handbook/Building Simple Databases/Designing Forms/Actions: Difference between revisions

From KDE UserBase Wiki
(Initial)
 
No edit summary
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Actions==
<languages/>
<translate>
====Actions==== <!--T:1-->


<!--T:2-->
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).  
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'''
===== Assigning actions to form buttons ===== <!--T:3-->


<!--T:4-->
Many actions can be assigned to form button. The assigned action is executed after button is clicked.  
Many actions can be assigned to form button. The assigned action is executed after button is clicked.  


<!--T:5-->
To assign action:
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 Assign action... command.
# An Assigning Action to Command 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 type drop down list has the No type item selected.
# From the Action type drop down list select Application item. Available application-wide actions will be listed.
# Select one of the actions on the list (e.g. Delete Row).
# Click the OK button or press the Enter key to accept your selection.


After switching to the form's data view you can try whether the action works. For example, if you assigned Delete Row action, clicking the button, the current database row will be deleted, similarly to executing Edit->Delete Row (Ctrl+Delete) menu command (depending on your settings you may be asked to confirm the removal).  
<!--T:6-->
# Switch to form's Design view if you have not done yet.</translate>
<translate>
<!--T:11-->
# 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 <keycap>Enter</keycap> key. </translate>
<translate>
<!--T:12-->
# Click the button widget with the right mouse button to display the context menu. </translate>
<translate>
<!--T:13-->
# From the context menu select <menuchoice>Assign action...</menuchoice> command. </translate>
<translate>
<!--T:14-->
# 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>
<!--T:15-->
# From the '''Action category''' list select <menuchoice>Application actions</menuchoice> item. Available application-wide actions will be listed. </translate>
<translate>
<!--T:16-->
# Select one of the actions on the list (e.g. <menuchoice>Delete Selected object</menuchoice>).</translate>
<translate>
<!--T:17-->
<!--dialog closes immediately after clicking an action in the list
# Click the <menuchoice>OK</menuchoice> button or press the <keycap>Enter</keycap> key to accept your selection. -->


{{Note|
<!--T:7-->
* To remove an action assignment, select No type item from the Action type drop down list of the Assigning Action to Command Button dialog window.  
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). -->
* Actions only work in the form's data view. Not every action's assignment is reasonable. For example, the Font... 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:8-->
{{Note|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-->
* 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-->
{{Prevnext2
|prevpage=Special:MyLanguage/Kexi/Handbook/Building_Simple_Databases/Designing_Forms/Inserting_text_labels
|prevtext=Inserting text labels
|nextpage=Special:MyLanguage/Kexi/Handbook/Building_Simple_Databases/Designing_Forms/Widget_layouts
|nexttext=Widget layouts
|index=Special:MyLanguage/Kexi/Handbook|indextext=Back to menu
}}
 
<!--T:10-->
[[Category:Kexi]]
[[Category:Tutorials]]
</translate>

Latest revision as of 06:51, 16 May 2014

Other languages:

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:

  1. Switch to form's Design view if you have not done yet.
  2. 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.
  3. Click the button widget with the right mouse button to display the context menu.
  4. From the context menu select Assign action... command.
  5. 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 No action item selected.
  6. From the Action category list select Application actions item. Available application-wide actions will be listed.
  7. Select one of the actions on the list (e.g. Delete Selected object).

After switching to the form's data view you can try whether the action works.

Note

To remove an action assignment, select the No action 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 Font... 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.