NAME

whotspot_set − set hotspot data

SYNOPSIS

int whotspot_set(fd,hotspot_id,bmask,x,y,w,h,event_byte);
int fd;
int hotspot_id;
int bmask;
int x,y,w,h;
int event_byte;

DESCRIPTION

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

hotspot_id
is the identifier for an existing hotspot.

bmask
is the button bit mask for activating the hotspot.

x,y are the coordinates of the upper left corner of the rectangular hotspot region in device units relative to the upper left corner of the virtual raster of the window. 

w,h are the width and height of the rectangular hotspot region in device units.  These parameters must be greater than zero. 

event_byte
is the event to occur when the hotspot is activated.

DISCUSSION

This routine sets the data for the hotspot identified by hotspot_id for the window specified by the opened fd. 

A hotspot can be disabled, by setting bmask to 0 or by placing the hotspot outside of the virtual raster of the window (e.g., set x and y to -10,-10 and w and h to 1,1). 

The parameters are defined more thoroughly in the whotspot_create(3W) page.

HARDWARE DEPENDENCIES

Series 500:
Hotspot routines (whotspot_∗) are not supported on Series 500; they work only on Series 300.

SEE ALSO

whotspot_create(3W),whotspot_delete(3W),whotspot_get(3W),winput_read(3W), wsetsigmask(3W), weventpoll(3W). 

DIAGNOSTICS

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

Hewlett-Packard Company  —  May 11, 2021