/text/shared/02/01170103.xhp

controls; events events; controls macros; assigning to events in forms Events 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 Assign Macro dialog 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: Approve actionrenamed from Before commencing, issue 97356 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. Execute actionrenamed from When initiated, issue 97356 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. Changed The Changed event takes place when the control loses the focus and the content of the control has changed since it lost the focus. Text modified 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 the status of the control field has 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 looses the focus. Key pressed 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. Key released The Key released event occurs when the user releases any key while the control has the focus. Mouse inside 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). Mouse moved The Mouse moved event occurs if the mouse moves over the control. Mouse button pressed 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. Mouse button released The Mouse button released event occurs if the mouse button is released while the mouse pointer is on the control. Mouse outside The Mouse outside event takes place when the mouse is outside the control field.