get_mbutton_sub_pix
— Wait until a mouse button is pressed and get the subpixel mouse position.
get_mbutton_sub_pix( : : WindowHandle : Row, Column, Button)
get_mbutton_sub_pix
returns the subpixel accurate image coordinates
of the mouse pointer in the output window and the mouse button pressed.
In addition the state of the modifier keys is returned. The following
values are assigned to the individual buttons and keys:
Left button,
Middle button,
Right button,
Shift key,
Ctrl key,
Alt key.
The sum of the values for all pressed buttons/keys is returned in
Button
.
The operator waits until a button is pressed in the output
window. For graphics windows the coordinates Row
and
Column
are expressed with consideration of the current image part
(see set_part
).
If only pixel accurate image coordinates are required, you can use the
operator get_mbutton
.
get_mbutton_sub_pix
only returns if a mouse button is pressed in
the window.
WindowHandle
(input_control) window →
(handle)
Window handle.
Row
(output_control) point.y →
(real)
Row coordinate of the mouse cursor in the image coordinate system.
Column
(output_control) point.x →
(real)
Column coordinate of the mouse cursor in the image coordinate system.
Button
(output_control) integer →
(integer)
Mouse button(s) pressed.
get_mbutton_sub_pix
returns the value 2 (H_MSG_TRUE).
get_mbutton
,
get_mposition
,
get_mposition_sub_pix
Foundation