LibreOffice 24.8 Help
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. The Assign Action dialogue box opens.
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:
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.
The Item status changed event takes place if the status of the control field has changed, for example, from checked to unchecked.
The When receiving focus event takes place if a control field receives the 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.
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 pop-up 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.