When any of the mouse events occur, Oracle Forms initializes the appropriate mouse event system variable (see below) and executes the corresponding mouse trigger.
Note: Mouse system variables are set immediately before a mouse trigger is fired. To guarantee that your mouse system variables are updated, you should only use the mouse system variables within mouse triggers.
Mouse Event System Variable |
Value |
---|---|
SYSTEM.MOUSE_BUTTON_MODIFIERS | Identifies which special key was pressed to modify the usual mouse button action (possible values are Shift+, Caps Lock+, Control+, Alt+, Command+, Super+, and Hyper+) Note: Similar to SYSTEM.MOUSE_BUTTON_SHIFT_STATE, but is not language-dependent. |
SYSTEM.MOUSE_BUTTON_PRESSED |
The number of the button, either 1, 2, or 3 (left, middle, or right) that was pressed. |
SYSTEM.MOUSE_BUTTON_SHIFT_STATE |
The shift modifier pressed during the mouse click. The value returned is language and operating system dependent of the middle tier. |
SYSTEM.MOUSE_CANVAS |
The name of the canvas which the mouse is currently in. |
SYSTEM.MOUSE_ITEM |
The name of the item the mouse is currently in. |
SYSTEM.MOUSE_RECORD |
The record number of the record the mouse is in. |
SYSTEM.MOUSE_RECORD_OFFSET |
The offset from the first visible record that the mouse is in. |
SYSTEM.MOUSE_X_POS |
The current mouse X-coordinate on the canvas according to the coordinate system except when used within a When-Mouse-Enter trigger. When using a When-Mouse-Enter trigger, SYSTEM.MOUSE_X_POS represents the X-coordinate relative to the item entered, not the item position on the canvas. |
SYSTEM.MOUSE_Y_POS |
The current mouse Y-coordinate on the canvas according to the coordinate system except when used within a When-Mouse-Enter trigger. When using a When-Mouse-Enter trigger, SYSTEM.MOUSE_Y_POS represents the Y-coordinate relative to the item entered, not the item position on the canvas. |
Note: Oracle Forms does not perform mouse navigation internally to fire the mouse triggers. As a result, mouse move, enter, and leave can fire on the non-current item, or on an item that does not contain a record (for example, the fifth record in a multi-record block which is in Enter Query mode).