On the Events tab page you can link macros to events that occur in a form's control fields.
When the event occurs, the linked macro will be called. To assign a macro to an event, press the ... button. An When in Writer: Assign Macrodialog opens.
Open context menu of a selected form element - choose Control - Events tab
Open Form Controls toolbar or Form Design toolbar, click Control icon - Events tab
Depending on the control, different events are available. Only the available events for the selected control and context are listed on the Events tab page. The following events are defined:
- 1 Approve action
- 2 Execute action
- 3 Changed
- 4 Text modified
- 5 Item status changed
- 6 When receiving focus
- 7 When losing focus
- 8 Key pressed
- 9 Key released
- 10 Mouse inside
- 11 Mouse moved while key pressed
- 12 Mouse moved
- 13 Mouse button pressed
- 14 Mouse button released
- 15 Mouse outside
- 16 Before update
- 17 After update
- 18 Prior to reset
- 19 After resetting
This event takes place before an action is triggered by clicking the control. For example, clicking a "Submit" button initiates a send action; however, the actual "send" process is started only when the When initiating event occurs. The Approve action event allows you to kill the process. If the linked method sends back FALSE, When initiating will not be executed.
The Execute action event occurs when an action is started. For example, if you have a "Submit" button in your form, the send process represents the action to be initiated.
The Changed event takes place when the control loses the focus and the content of the control has changed since it lost the focus.
The Text modified event takes place if you enter or modify a text in an input field.
Item status changed
The Item status changed event takes place if he status of the control field has changed.
When receiving focus
The When receiving focus event takes place if a control field receives the focus.
When losing focus
The When losing focus event takes place if a control field loses the focus.
The Key pressed event occurs when the user presses any key while the control has the focus. This event may be linked to a macro for checking entries.
The Key released event occurs when the user releases any key while the control has the focus.
The Mouse inside event takes place if the mouse is inside the control field.
Mouse moved while key pressed
The Mouse moved while key pressed event takes place when the mouse is dragged while a key is pressed. An example is when, during drag-and-drop, an additional key determines the mode (move or copy).
The Mouse moved event occurs if the mouse moves over the control.
The Mouse button pressed event occurs if the mouse button is pressed while the mouse pointer is on the control.
|Note that this event is also used for notifying requests for a popup context menu on the control.|
The Mouse button released event occurs if the mouse button is released while the mouse pointer is on the control.
The Mouse outside event takes place when the mouse is outside the control field.
The Before update event occurs before the control content changed by the user is written into the data source. The linked macro can, for example, prevent this action by returning "FALSE".
The After update event occurs after the control content changed by the user has been written into the data source.
Prior to reset
The Prior to reset event occurs before a form is reset. The linked macro can, for example, prevent this action by returning "FALSE".
A form is reset if one of the following conditions is met:
- The user presses an (HTML) button that is defined as a reset button.
- A new and empty record is created in a form that is linked to a data source. For example, in the last record, the Next Record button may be pressed.
The After resetting event occurs after a form has been reset.