Difference between revisions of "Action Objects"

From GeoGebra Manual
Jump to: navigation, search
m
Line 1: Line 1:
<noinclude>{{Manual Page|version=5.0}}</noinclude>
+
<noinclude>{{Manual Page|version=5.0}}</noinclude>{{objects}}
{{objects}}
+
For interactive worksheets with [[Scripting|scripting]] Action Objects may come handy.<br>
For interactive worksheets with [[Scripting|scripting]] Action Objects may come handy. There are four types of them
+
There are four types of them:
 
==Checkboxes==
 
==Checkboxes==
Checkboxes are graphical representations of [[Boolean values]]. See [[Check Box Tool]] for details.
+
Checkboxes are graphical representations of [[Boolean values]]. See [[File:Mode showcheckbox.svg|link=|22px]] [[Check Box Tool]] for details.
Checkboxes can be created using the aforementioned tool or [[Checkbox Command]].
+
Checkboxes can be created using the aforementioned tool or the [[Checkbox Command]].
 
==Input Boxes==
 
==Input Boxes==
 
Input Boxes work as text inputs for [[Scripting|scripts]]. The script is triggered by changing text in the Input Box and either pressing enter or leaving the Input Box. The inserted value may be accessed using the %0 variable.
 
Input Boxes work as text inputs for [[Scripting|scripts]]. The script is triggered by changing text in the Input Box and either pressing enter or leaving the Input Box. The inserted value may be accessed using the %0 variable.
 
{{example|1=Input Box with <code>a=a+%0</code> in script will increase number ''a'' by the entered value. Works only if ''a'' is [[Free, Dependent and Auxiliary Objects|free]].}}
 
{{example|1=Input Box with <code>a=a+%0</code> in script will increase number ''a'' by the entered value. Works only if ''a'' is [[Free, Dependent and Auxiliary Objects|free]].}}
If you want the Input Box to change value of a free object (or redefine dependent object), you may define that object as linked. This way you don't have to insert any script.
+
If you want the Input Box to change value of a free object (or redefine dependent object), you may define that object as linked. This way you don't have to insert any script.<br>
Input Boxes can be created using [[Input Box Tool]] or [[InputBox Command]].
+
Input Boxes can be created using the [[File:Mode textfieldaction.svg|link=|22px]] [[Input Box Tool]] or the [[InputBox Command]].
 
==Buttons==
 
==Buttons==
Buttons are meant to trigger scripts by being clicked. Although scripts can be triggered by clicking any other object (e.g. an [[Image Tool|image]]), using buttons for this makes your worksheet more intuitive.
+
Buttons are meant to trigger scripts by being clicked. Although scripts can be triggered by clicking any other object (e.g. an [[Image Tool|image]]), using buttons for this makes your worksheet more intuitive.<br>
Input Boxes can be created using [[Button Tool]] or [[Button Command]].
+
Buttons can be created using the [[File:Mode buttonaction.svg|link=|22px]] [[Button Tool]] or the [[Button Command]].
 
==Drop-down lists==
 
==Drop-down lists==
If you want to show the contents of a list in a drop-down list:
+
If you want to show the contents of a list in a drop-down list
* in the [[File:Menu view graphics.svg|link=|16px]] [[Graphics View]]: check the ''Draw as drop-down list'' box in the ''Basics'' tab of the ''Properties'' dialog window of the list.
+
* in the [[File:Menu view graphics.svg|link=|16px]] [[Graphics View]]: check the ''Draw as drop-down list'' box in the ''Basics'' tab of the [[File:Menu-options.svg|link=|18px]] [[Properties Dialog]] of the list.
* in the [[File:Menu view spreadsheet.svg|link=|16px]] [[Spreadsheet View]]: enter a list into the spreadsheet, then check the ''Use Buttons and Checkboxes'' box in the ''Layout'' tab of [[Options Dialog]].   
+
* in the [[File:Menu view spreadsheet.svg|link=|16px]] [[Spreadsheet View]]: enter a list into the spreadsheet, then check the ''Use Buttons and Checkboxes'' box in the [[File:Menu view spreadsheet.svg|link=|16px]] ''Spreadsheet Options''.   
 
The selected element of a drop-down list may be also obtained using [[SelectedIndex Command|SelectedIndex ]] and [[SelectedElement Command|SelectedElement ]] commands.
 
The selected element of a drop-down list may be also obtained using [[SelectedIndex Command|SelectedIndex ]] and [[SelectedElement Command|SelectedElement ]] commands.

Revision as of 10:36, 9 October 2015


For interactive worksheets with scripting Action Objects may come handy.
There are four types of them:

Checkboxes

Checkboxes are graphical representations of Boolean values. See Mode showcheckbox.svg Check Box Tool for details. Checkboxes can be created using the aforementioned tool or the Checkbox Command.

Input Boxes

Input Boxes work as text inputs for scripts. The script is triggered by changing text in the Input Box and either pressing enter or leaving the Input Box. The inserted value may be accessed using the %0 variable.

Example: Input Box with a=a+%0 in script will increase number a by the entered value. Works only if a is free.

If you want the Input Box to change value of a free object (or redefine dependent object), you may define that object as linked. This way you don't have to insert any script.
Input Boxes can be created using the Mode textfieldaction.svg Input Box Tool or the InputBox Command.

Buttons

Buttons are meant to trigger scripts by being clicked. Although scripts can be triggered by clicking any other object (e.g. an image), using buttons for this makes your worksheet more intuitive.
Buttons can be created using the Mode buttonaction.svg Button Tool or the Button Command.

Drop-down lists

If you want to show the contents of a list in a drop-down list

  • in the Menu view graphics.svg Graphics View: check the Draw as drop-down list box in the Basics tab of the Menu-options.svg Properties Dialog of the list.
  • in the Menu view spreadsheet.svg Spreadsheet View: enter a list into the spreadsheet, then check the Use Buttons and Checkboxes box in the Menu view spreadsheet.svg Spreadsheet Options.

The selected element of a drop-down list may be also obtained using SelectedIndex and SelectedElement commands.

© 2024 International GeoGebra Institute