GET MOUSE Statement
GET MOUSE numvar, numvar, numvar
GET MOUSE: numvar, numvar, numvar
The GET MOUSE statement returns the current position of the mouse and its current state. On mice with multiple
buttons, only the state and position of the left-most button is reported. The current x- and y-coordinates of the current
position, in user coordinates, are assigned to the first two numvars, respectively. If one or more picture
transformations are in effect, their inverse is applied before assigning to the variables. The current state of the mouse is
assigned to the third numvar according to the following table:
0 No button Down
1 Button Down
2 Button clicked at this point
3 Button released at this point
4 Button shift-clicked at this point
The values assigned to the two variables may be outside the current logical window; they are not "clipped" and are
given in terms of the current user coordinates.
The state of the mouse is determined within a certain time interval that is dependent on the particular machine. Thus,
even if the GET MOUSE statement is executed continuously, as within a tight loop, it may nonetheless miss the exact
moments when the button is being clicked or released.
GET MOUSE is provided primarily for compatibility with earlier versions of True BASIC. This version of the
language provides more reliable and flexible means of getting mouse input via the Sys_Event routine (see Chapter 20
"Sys_Event Subroutine") or the TC_Event library routine (see Chapter 14 "Interface Elements"). The GET MOUSE
statement will not work if program-controlled event handling (via Sys_Event or TC_Event) is in effect.