A script-enabled browser is required for this page to function properly.

Using Mouse Event System Variables

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).


About mouse events, triggers, and system variables