GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
TERMKEY_INTERPRET_MOUSE(3) FreeBSD Library Functions Manual TERMKEY_INTERPRET_MOUSE(3)

termkey_interpret_mouse - interpret opaque mouse event data

#include <termkey.h>

TermKeyResult termkey_interpret_mouse(TermKey *tk, const TermKeyKey *key, 
    TermKeyMouseEvent *ev, int *button, int *line, int *col);

Link with -ltermkey.

termkey_interpret_mouse() fills in variables in the passed pointers according to the mouse event found in key. It should be called if termkey_getkey(3) or similar have returned a key event with the type of TERMKEY_TYPE_MOUSE.

Any pointer may instead be given as NULL to not return that value.

The ev variable will take one of the following values:

TERMKEY_MOUSE_UNKNOWN
an unknown mouse event.
TERMKEY_MOUSE_PRESS
a mouse button was pressed; button will contain its number.
TERMKEY_MOUSE_DRAG
the mouse was moved while holding a button; button will contain its number.
TERMKEY_MOUSE_RELEASE
a mouse button was released, or the mouse was moved while no button was pressed. If known, button will contain the number of the button released. Not all terminals can report this, so it may be 0 instead.

The line and col variables will be filled in with the mouse position, indexed from 1. Note that due to the limited number of bytes in the TermKeyKey structure, the line and column numbers are limited to 2047 and 4095 respectively.

If passed a key event of the type TERMKEY_TYPE_MOUSE, this function will return TERMKEY_RES_KEY and will affect the variables whose pointers were passed in, as described above.

For other event types it will return TERMKEY_RES_NONE, and its effects on any variables whose pointers were passed in, are undefined.

termkey_waitkey(3), termkey_getkey(3), termkey(7)

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.