WHEN TRIGGERS

WHEN TRIGGERS
When-Button-Pressed
Description
Fires when an operator selects a button, by clicking with a mouse, or using the keyboard.
Definition Level form, block, or item
When-List-Changed
Description
Fires when an end user selects a different element in a list item or de-selects the currently selected element. In addition, if a
When-List-Changed trigger is attached to a combo box style list item, it fires each time the end user enters or modifies entered
text.
Definition Level form, block, or item
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode yes
When-Clear-Block
Description
Fires just before Form Builder clears the data from the current block.
Note that the When-Clear-Block trigger does not fire when Form Builder clears the current block during the CLEAR_FORM event.
Definition Level form or block
Legal Commands
SELECT statements, unrestricted built-ins
Enter Query Mode yes
When-Form-Navigate
Description
Fires when navigation between forms takes place, such as when the user changes the focus to another loaded form.
Definition Level form
Legal Commands:
unrestricted built-ins, restricted built-ins
Enter Query Mode:
When-Mouse-DoubleClick
Description
Fires after the operator double-clicks the mouse if one of the following events occurs:
if attached to the form, when the mouse is double-clicked within any canvas or item in the form
if attached to a block, when the mouse is double-clicked within any item in the block
if attached to an item, when the mouse is double-clicked within the item
Six events must occur before a When-Mouse-DoubleClick trigger will fire:
Mouse down
Mouse up
Mouse click
Mouse down
Mouse up
Mouse double-click
Any trigger that is associated with these events will fire before the When-Mouse-DoubleClick trigger fires.
Definition Level form, block, or item
Legal Commands
SELECT statements, restricted built-ins, unrestricted built-ins
Enter Query Mode yes
When-Mouse-Enter
Description
Fires when the mouse enters an item or canvas if one of the following events occurs:
if attached to the form, when the mouse enters any canvas or item in the form
if attached to a block, when the mouse enters any item in the block
if attached to an item, when the mouse enters the item
Definition Level form, block, or item
Legal Commands
SELECT statements, restricted built-ins, unrestricted built-ins
Enter Query Mode yes
When-Mouse-Move
Description
Fires each time the mouse moves if one of the following events occurs:
if attached to the form, when the mouse moves within any canvas or item in the form
if attached to a block, when the mouse moves within any item in the block
if attached to an item, when the mouse moves within the item
Definition Level form, block, or item
Legal Commands
SELECT statements, restricted built-ins, unrestricted built-ins
Enter Query Mode yes
When-New-Block-Instance
Description
Fires when the input focus moves to an item in a different block. Specifically, it fires after navigation to an item, when Form
Builder is ready to accept input in a block that is different than the block that previously had the input focus.
Definition Level form or block
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode no
When-New-Item-Instance
Description
Fires when the input focus moves to an item. Specifically, it fires after navigation to an item, when Form Builder is ready to
accept input in an item that is different than the item that previously had input focus.
Definition Level form, block, or item
Legal Commands
SELECT statements, restricted built-ins, unrestricted built-ins.
Enter Query Mode yes
When-Radio-Changed
Description
Fires when an operator selects a different radio button in a radio group, or de-selects the currently selected radio button, either
by clicking with the mouse, or using the keyboard.
Definition Level form, block, or item
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode yes
When-Tab-Page-Changed
Description
Fires whenever there is explicit item or mouse navigation from one tab page to another in a tab canvas.
Definition Level form
Legal Commands
unrestricted built-ins, restricted built-ins
Enter Query Mode no
When-Validate-Item
Description
Fires during the Validate the Item process. Specifically, it fires as the last part of item validation for items with the New or
Changed validation status.
Definition Level form, block, or item
Legal Commands
SELECT statements, unrestricted built-ins
Enter Query Mode no
When-Window-Activated
Description
Fires when a window is made the active window. This occurs at form startup and whenever a different window is given focus.
Note that on some window managers, a window can be activated by clicking on its title bar. This operation is independent of
navigation to an item in the window. Thus, navigating to an item in a different window always activates that window, but
window activation can also occur independently of navigation.
Definition Level form
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode yes
When-Window-Deactivated
Description
Fires when an operator deactivates a window by setting the input focus to another window within the same form.
Definition Level form
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode yes
When-Image-Pressed
Description
Fires when an operator uses the mouse to:
single-click on an image item
double-click on an image item
Note that When-Image-Activated also fires on a double-click.
Definition Level form, block, or item
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode yes
When-Checkbox-Changed
Description
Fires when an operator changes the state of a check box, either by clicking with the mouse, or using the keyboard.
Definition Level form, block, or item
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode yes
When-Create-Record
Description
Fires when Form Builder creates a new record. For example, when the operator presses the [Insert] key, or navigates to the
last record in a set while scrolling down, Form Builder fires this trigger.
Definition Level form or block
Legal Commands
SELECT statements, unrestricted built-ins
Enter Query Mode no
When-Database-Record
Description
Fires when Form Builder first marks a record as an insert or an update. That is, the trigger fires as soon as Form Builder
determines through validation that the record should be processed by the next post or commit as an insert or update. This
generally occurs only when the operator modifies the first item in a record, and after the operator attempts to navigate out of
the item.
Definition Level form or block
Legal Commands
SELECT statements, unrestricted built-ins
Enter Query Mode no
When-Image-Activated
Description
Fires when an operator uses the mouse to:
single-click on an image item
double-click on an image item
Note that When-Image-Pressed also fires on a double-click.
Definition Level form, block, or item
Legal Commands
SELECT statements, unrestricted built-ins
Enter Query Mode no
When-List-Activated
Description
Fires when an operator double-clicks on an element in a list item that is displayed as a T-list.
Definition Level form, block, or item
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode yes
When-Mouse-Click
Description
Fires after the operator clicks the mouse if one of the following events occurs:
if attached to the form, when the mouse is clicked within any canvas or item in the form
if attached to a block, when the mouse is clicked within any item in the block
if attached to an item, when the mouse is clicked within the item
Three events must occur before a When-Mouse-Click trigger will fire:
Mouse down
Mouse up
Mouse click
Any trigger that is associated with these events will fire before the When-Mouse-Click trigger fires.
Definition Level form, block, or item
Legal Commands
SELECT statements, restricted built-ins, unrestricted built-ins
Enter Query Mode yes
When-Mouse-Down
Description
Fires after the operator presses down the mouse button if one of the following events occurs:
if attached to the form, when the mouse is pressed down within any canvas or item in the form
if attached to a block, when the mouse is pressed down within any item in the block
if attached to an item, when the mouse is pressed within the item
Definition Level form, block, or item
Legal Commands
SELECT statements, restricted built-ins, unrestricted built-ins
Enter Query Mode yes
When-Mouse-Leave
Description
Fires after the mouse leaves an item or canvas if one of the following events occurs:
if attached to the form, when the mouse leaves any canvas or item in the form
if attached to a block, when the mouse leaves any item in the block
if attached to an item, when the mouse leaves the item
Definition Level form, block, or item
Legal Commands
SELECT statements, restricted built-ins, unrestricted built-ins
Enter Query Mode yes
When-Mouse-Up
Description
Fires each time the operator presses down and releases the mouse button if one of the following events occurs:
if attached to the form, when the mouse up event is received within any canvas or item in a form
if attached to a block, when the mouse up event is received within any item in a block
if attached to an item, when the mouse up event is received within an item
Two events must occur before a When-Mouse-Up trigger will fire:
Mouse down
Mouse up
Definition Level form, block, or item
Legal Commands
SELECT statements, restricted built-ins, unrestricted built-ins
Enter Query Mode yes
When-New-Form-Instance
Description
At form start-up, Form Builder navigates to the first navigable item in the first navigable block. A When-New-Form-Instance
trigger fires after the successful completion of any navigational triggers that fire during the initial navigation sequence.
This trigger does not fire when control returns to a calling form from a called form.
In a multiple-form application, this trigger does not fire when focus changes from one form to another.
Definition Level form
Legal Commands
SELECT statements, restricted built-ins, unrestricted built-ins
Enter Query Mode no
When-New-Record-Instance
Description
Fires when the input focus moves to an item in a record that is different than the record that previously had input focus.
Specifically, it fires after navigation to an item in a record, when Form Builder is ready to accept input in a record that is
different than the record that previously had input focus.
Fires whenever Form Builder instantiates a new record.
Definition Level form or block
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode yes
When-Remove-Record
Description
Fires whenever the operator or the application clears or deletes a record.
Definition Level form, block, or item
Legal Commands
SELECT statements, unrestricted built-ins
Enter Query Mode no
When-Timer-Expired
Description
Fires when a timer expires.
Definition Level form
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode yes
When-Validate-Record
Description
Fires during the Validate the Record process. Specifically, it fires as the last part of record validation for records with the New or
Changed validation status.
Definition Level form or block
Legal Commands
SELECT statements, unrestricted built-ins
Enter Query Mode no
When-Window-Closed
Description
Fires when an operator closes a window using a window-manager specific Close command.
Definition Level form
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode yes
When-Window-Resized
Description
Fires when a window is resized, either by the operator or programmatically through a call to RESIZE_WINDOW or
SET_WINDOW_PROPERTY. (Even if the window is not currently displayed, resizing the window programmatically fires the When-
Window-Resized trigger.) This trigger also fires at form startup, when the root window is first drawn. It does not fire when a
window is iconified.
Definition Level form
Legal Commands
SELECT statements, unrestricted built-ins, restricted built-ins
Enter Query Mode yes