X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_mouse.3x.html;h=81fe57a23d4a915e6d2dc3ceeaaba063abe7eaa7;hp=2506e2b50267848a3a7c123e1e03de37da7b81f0;hb=89730563d0a660d4ddd83d28660dc23c6d3f0bed;hpb=ed646e3f683083e787c6ba773364401dc9fa9d40 diff --git a/doc/html/man/curs_mouse.3x.html b/doc/html/man/curs_mouse.3x.html index 2506e2b5..81fe57a2 100644 --- a/doc/html/man/curs_mouse.3x.html +++ b/doc/html/man/curs_mouse.3x.html @@ -1,7 +1,8 @@ - + curs_mouse 3x - + @@ -247,24 +248,24 @@ SVr4 curses had support for the mouse in a variant of xterm. It is mentioned in a few places, but with no supporting documentation: - o the libcurses manual page lists functions for this feature which + o the "libcurses" manual page lists functions for this feature which are prototyped in curses.h: - extern int mouse_set(long int); - extern int mouse_on(long int); - extern int mouse_off(long int); - extern int request_mouse_pos(void); - extern int map_button(unsigned long); - extern void wmouse_position(WINDOW *, int *, int *); - extern unsigned long getmouse(void), getbmap(void); + extern int mouse_set(long int); + extern int mouse_on(long int); + extern int mouse_off(long int); + extern int request_mouse_pos(void); + extern int map_button(unsigned long); + extern void wmouse_position(WINDOW *, int *, int *); + extern unsigned long getmouse(void), getbmap(void); - o the terminfo manual page lists capabilities for the feature + o the "terminfo" manual page lists capabilities for the feature - buttons btns BT Number of buttons on the mouse - get_mouse getm Gm Curses should get button events - key_mouse kmous Km 0631, Mouse event has occured - mouse_info minfo Mi Mouse status information - req_mouse_pos reqmp RQ Request mouse position report + buttons btns BT Number of buttons on the mouse + get_mouse getm Gm Curses should get button events + key_mouse kmous Km 0631, Mouse event has occurred + mouse_info minfo Mi Mouse status information + req_mouse_pos reqmp RQ Request mouse position report o the interface made assumptions (as does ncurses) about the escape sequences sent to and received from the terminal. @@ -319,6 +320,10 @@ \E[?1000%?%p1%{1}%=%th%el%; + The mouse driver also recognizes a newer xterm private mode 1006, e.g., + + \E[?1006;1000%?%p1%{1}%=%th%el%; + The z member in the event structure is not presently used. It is in- tended for use with touch screens (which may be pressure-sensitive) or with 3D-mice/trackballs/power gloves. @@ -343,9 +348,11 @@ Because there are no standard terminal responses that would serve to identify terminals which support the xterm mouse protocol, ncurses as- - sumes that if your $TERM environment variable contains "xterm", or - kmous is defined in the terminal description, then the terminal may - send mouse events. + sumes that if kmous is defined in the terminal description, or if the + terminal description's primary name or aliases contain the string + "xterm", then the terminal may send mouse events. The kmous capability + is checked first, allowing the use of newer xterm mouse protocols such + as xterm's private mode 1006.

SEE ALSO