Text Viewer: _registerHotspots

Text Viewer: _registerHotspots

Defines areas as hotspots to be returned by the _getInfo method

Syntax
Details
Example
See Also

Syntax

CALL NOTIFY (viewer-name, '_registerHotspots', hotspot-info-1

<..., hotspot-info-n>;

);

Each hotspot-info item must contain all of the following arguments in this order and separated by commas:

Argument Type Description

hotspot-name
C specifies the name under which to register the hotspot

start-row
N specifies the starting row of the first hotspot

start-col
N specifies the starting column of the first hotspot

end-row
N specifies the ending row of the first hotspot

end-col
N specifies the ending column of the first hotspot

Argument	Type	Description
hotspot-name	C	specifies the name under which to register the hotspot
start-row	N	specifies the starting row of the first hotspot
start-col	N	specifies the starting column of the first hotspot
end-row	N	specifies the ending row of the first hotspot
end-col	N	specifies the ending column of the first hotspot

Details

You may register more than one hotspot by passing more than one group of name and coordinates arguments.

Example

This example creates two hotspots and checks to see if a click occurred within one of them:

init:
   /* register two hotspots named ONE
      and TWO */
call notify('textview','_register_hotspots_',
            'one', 1, 1, 3, 3,
            'two', 6, 6, 9, 9);
return;

textview:
    /* see if click was in hotspot */
call notify ('textview', '_get_info_',
              row, col, text, textl,
             word, wordl, hotspot);
return;

If the user clicked on row 8, column 8, which is in the second registered hotspot, the value of HOTSPOT would be 'TWO'.

See Also

_unregisterHotspots in this class.

Chapter Contents
Previous
Next
Top of Page