NAME

wgetlocator − get window echo/locator parameter

SYNOPSIS

int wgetlocator(fd,x,y,buttons);
int fd;
int *x,*y,*buttons;

DESCRIPTION

fd is an integer file descriptor for an opened window type device interface. 

x,y contain the current echo position.  x and y are relative to the current window data space (not the screen).  They are also in pixel units.  The echo hot spot determines which part of the echo is actually at the coordinates, see wsetrasterecho and wsetecho.  For a window type, they are relative to the contents portion, not the border. 

buttons
specifies the current state of the locator buttons.  The least significant bit is associated with the left most button.  If a bit is set, then that button is down.

DISCUSSION

Get the current echo position and buttons state.  For higher performance, do gopen to get fd, or use wsetrasterecho on fd. 

SEE ALSO

wsetlocator(3W). 

DIAGNOSTICS

A return of -1 indicates failure; otherwise 0 is returned.  See errno(2) for more information.

Hewlett-Packard Company  —  May 11, 2021