1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61
|
.TH xclick 2 "April 1993" "Scilab Group" "Scilab Function"
.so ../sci.an
.SH NAME
xclick - wait for a mouse click
.SH CALLING SEQUENCE
.nf
[c_i,c_x,c_y]=xclick([flag])
[c_i,c_x,c_y,c_w]=xclick([flag])
[c_i,c_x,c_y,c_w,c_m]=xclick([flag])
.fi
.SH PARAMETERS
.TP 10
c_i
: integer (button number)
.TP 15
c_x,c_y
: real scalars (position)
.TP
c_w
: integer (window number)
.TP
c_m
: Character string (menu callback)
.TP
flag
: an integer. If present, the click event queue is not cleared when entering xclick
.SH DESCRIPTION
if called with 3 lhs arguments waits for a mouse click in the current
graphic window
.LP
if called with 4 or 5 lhs arguments waits for a mouse click in any graphic
window
.LP
returned values:
.TP
c_i
: an integer which gives the number of the mouse button that was pressed [0,1,2] (for [left,middle,right]) or i=-1 in case of problems with xclick.
.TP
c_x,c_y
: the coordinates in the current graphic scale
of the position of the mouse click.
.TP
c_w
: the window number where the click has occurred
.TP
c_m
: Character string associated with a dynamic menu. If xclick returns
due to a click on a menu, \fVc_i\fR, \fVc_x\fR, \fVc_y,\fR \fVc_w\fR take
arbitrary values.
.SH KNOWN TROUBLES
This function can return the message
\fVCan't grab the pointer\fR if the graphic window is iconified when
calling the function \fVxclick\fR.
.SH SEE ALSO
locate
.SH AUTHOR
J.Ph.C.
|