Sage-ST ^TM Mouse Support

The mouse cursor is moved separately from the standard cursor. The mouse cursor is used as a locator.

When a form is first displayed, or after positioning the normal cursor at the mouse cursor position using the left or right button, the mouse cursor becomes invisible. It will become visible again wwhen the mouse is moved.

The left or right buttons may be held down during mouse movement or when in the desired position. Positioning of the standard cursor and execution occurs when the button is released. If passing through highlighted or entry fields on a form while a button is depressed, the highlight color of that field will be shown. The standard cursor will only be positioned if the mouse cursor is in a valid entry or highlighted field upon button release.

The left button positions the standard cursor if in a valid field and executes its defined function only if it is in a highlighted field. The left button execution function defaults to the standard exit (10), but may be redefined within the keyboard sets in THOR. The only exception to this is the outside form exit (61). If this is defined by the current keyboard set, the left button will cause an exit if the button is released when the mouse cursor is outside the form's window.

The right button positions the standard cursor if in a valid field and executes its defined function regardless of the cursor position. The left button execution function defaults to none (0), but may be redefined within the keyboard sets in THOR.

In a variable highlighted form presented by Display.DisplayFormV, or Display.DisplayFormVIP, the mouse cursor will not cause the list to scroll beyond the current page of options. This may be accomplished by using the standard arrow or paging keys or associating one of these functions to the right button.

In a Display.ScrollForm presentation, the mouse may be used to scroll by positioning the cursor above or below the top or bottom scrolling region and clicking the left button. Positioning above or below the current line(s) but within the scrolling region and clicking the left button will cause the position to move to the indicated scrollable region. If a highlighted field appears on the outside form and the mouse is resident in that field when it is released, the contents of that highlighted field will be sent to the associated memory record area and the button function will be executed.

Display.EnableMouse and Display.DisableMouse cause the mouse to be shown or not shown on a form. Display.EnableMouse performs the mouse initialization function when called the first time in a program.

warren.merrill@inl.gov , ftp://sage.inel.gov
Copyright © 1989-2006. Battelle Energy Alliance