SET(WIDGET_CONTEXT_HELP)
Specifies the widget within which context-sensitive help interaction will
occur until the user clicks M1 on a widget. Valid only in the Motif
DECwindows environment.
Syntax
SET (WIDGET_CONTEXT_HELP, widget, {ON | 1 | OFF | 0})
Parameters
WIDGET_CONTEXT_HELP A keyword directing DECTPU to enter the Motif
context-sensitive help mode in which the mouse
pointer changes to a question mark until the user
clicks M1 on a widget. The mouse pointer then
reverts to the default pointer shape, and a help
callback is called on the selected widget (or its
parent if the selected widget has no help
callback).
widget The widget instance within which the modal help
interaction will be limited. Applications will
normally specify the top level widget returned
from the GET_INFO (SCREEN, "widget") built-in. A
help callback occurs only when the mouse is
clicked on the specified widget or any of its
children widgets.
ON Confines the question mark pointer to the
specified widget. If any children widgets have
been moved outside the specified widget's
boundaries, then the question mark pointer cannot
be moved to those children unless this parameter
is OFF or 0.
1 Same as ON.
OFF Does not confine the question mark pointer to the
specified widget.
0 Same as OFF.
Example
The following statement enters context-sensitive help mode, and does
not restrict the question mark mouse pointer to the boundaries of the
top level DECTPU widget. This lets the pointer be moved to the
application dialog boxes that have been moved outside the DECTPU
boundaries.
SET (WIDGET_CONTEXT_HELP, GET_INFO (SCREEN, "widget"), OFF);