AT&T UNIX™PC Unix System V Users Manual - tenox

TRACK (3T) (AT&T UNIX PC only ) TRACK (3T)
appropriate character scale values. Thus, values of 0,0 for the
scaling parameters specify that all user-supplied coordinates are in
characters.
T_lastx and t_lasty are used internally by track to record the last
known x,y position of the mouse. In particular, when track �
returns to the caller, lastx and tasty will contain the position 1 .
which caused the return.
T_bicon is an optional icon to be used whenever the mouse is
located in the background (not in any rectangle).
T_umdata is used internally by track to record the state of the
mouse parameters on T_BEGIN and to restore them on T_END.
t_tkitems points to an array of track items (rectangles) which are
described below. The list is terminated by a rectangle whose x, y,
width, and height are all zero.
T_curi is a pointer to the current track item. On call, track
assumes the mouse is located within the rectangle pointed to by
curi. On return, curi points to the new current rectangle. A
value of 0 means the background. T_curi is set to 0 on
T_BEGIN.
Each track item (rectangle) has the following structure:
typedef struct
{
unsigned short
unsigned short
unsigned short
unsigned short
struct icon
int
} tkitem_t;
ti_x;
ti_y;
ti_w;
ti_h;
*ti_icon;
ti_val;
/* x position *I
/* y position *I
/* width *I
/* height * I
/* icon * I
/* user value *I
The first four parameters determine the location and size of the
rectangle. 0,0 is the upper-left corner. Each of these parameters
is scaled by the scaling factors.
Ti_icon points to an optional icon to be associated with this rectangle.
Whenever the mouse is located within the rectangle, this
particular icon is displayed.
Ti_val is a user-supplied value which is not used in the tracking
process.
FILES
lusr lincludeltrack.h
lusr lincludelsyslwindow .h
lusr lincludelkcodes.h
SEE ALSO
tam(3T), window(7).
DIAGNOSTICS
Track returns a key code (see kcodes.h) which determines what
key was pressed. 'Mouse' is returned when a mouse event
- 2-