An action expression can access the variables that indicate which tile was selected, and describe the tile's state at the time of the action.
The variable names are reserved, and their values are read-only and have no meaning except when they are accessed within an action expression.
|
Action expression variables |
|
|---|---|
|
Variable |
Description |
|
$key |
The key attribute of the tile that was selected. This variable applies to all actions. |
|
$value |
The string form of the current value of the tile, such as the string from an edit box, or a "1" or "0" from a toggle. This variable applies to all actions. If the tile is a list box (or pop-up list) and no item is selected, the $value variable will be nil. |
|
$data |
The application-managed data (if any) that was set just after new_dialog time by means of client_data_tile. This variable applies to all actions, but $data has no meaning unless your application has already initialized it by calling client_data_tile. |
|
$reason |
The reason code that indicates which user action triggered the action. Used with edit_box, list_box, image_button, and slider tiles. This variable indicates why the action occurred. Its value is set for any kind of action, but you need to inspect it only when the action is associated with an edit_box, list_box, image_button, or slider tile. |
If edit1 is a text box, the action expression in the following action_tile call is evaluated when the user exits the text box:
(action_tile "edit1" "(setq ns $value)")
The $value contains the string that the user entered, and the expression saves this in the ns variable.
The next example saves the name of the selected tile so that the program can refer to it:
(action_tile "edit1" "(setq newtile $key)")
The newtile variable is set to the key name of the selected tile, in this case "edit1". The $key variable is very useful within a function that serves as the action for several separate tiles. When a tile is named in more than one action_tile call, only the last such call (prior to start_dialog) has any effect. (It's as if you were to assign multiple values to the same variable.) The programmable dialog box (PDB) feature allows only one action per tile.