MOUSE Mnemonic - Create Mouse Hotspot




The 'MOUSE' mnemonic activates a region (hot spot) on the screen for mouse (pointing device) activity.




Number of the column that defines the left boundary of the mouse hotspot.


Number of the row that defines the upper boundary of the mouse hotspot.


Width of the mouse hotspot, in columns.


Height of the mouse hotspot, in rows.


Text to be transmitted whenever a pointing device button is single-clicked in the region. Using the empty string ("") while including the double_resp causes single clicks to be ignored.


Text to be transmitted whenever a pointing device button is double-clicked in this region. May only be specified if single_resp is also defined.

If a mouse button is held down and the pointer is dragged across one of these regions, the area is highlighted making it possible to browse the available options. Clicking or double-clicking on an activated region returns a response string to the program.

One instance of the 'MOUSE' mnemonic placed in a loop that generates an on-screen menu can permit operation of the menu with the pointing device as well as the keyboard. In this way, character-based software can be moved to GUI.

Either response string can be made to convey information about which pointing device button was clicked and the status of the Ctrl and Shift keys at the time. To do this, it is necessary to add special case-sensitive sequences to the response string:


Replaced With


A single percent sign.


"0", "1", or "2", depending on which pointing device button was clicked.


"0" or "1" ($30$ or $31$), depending on the Ctrl key status.


"0" or "1" ($30$ or $31$), depending on the Shift key status.

If no response strings are provided, any activated regions whose rectangles intersect with the specified rectangle are deactivated. 'MOUSE'(0,0,0,0) is a shortcut to deactivate all hot spots associated with this PRO/5 screen.

Hot spots are not associated with the Visual PRO/5 terminal window but rather with the Visual PRO/5 window or screen to which the 'MOUSE' mnemonic is written. A text screen may contain one or more virtual screens or windows. It is this type of window, or movable subset of the text screen, that may contain mouse hot spots.

When Visual PRO/5 starts, a window already exists and a distinction is unnecessary unless character-based windowing features are used. The distinction becomes important when multiple windows are displayed, or when windows are moved about the screen. Moving a window ('MOVE' mnemonic) preserves the locations of the hot spots, relative to the contents of that window. The destruction of a window ('POP' mnemonic) destroys all the hot spots associated with that window. The 'PUSH' mnemonic duplicates any hot spots. At any given time, only the currently active window's hot spots are operational.

It is possible to create a new text window, draw a menu in it, activate the menu items, read a response (from keyboard or pointing device), and then remove the text window. The activated regions are automatically dissolved. Clear, insert, and delete operations will dissolve any hot spots whose regions are affected.

See Also

Mnemonics - Alphabetical Listing

Mnemonics - Group Listing