XtPopupSpringLoaded() XtPopupSpringLoaded()
Name
XtPopupSpringLoaded - map a spring-loaded popup from within an application.
Synopsis
void XtPopupSpringLoaded(popup_shell)
Widget popup_shell;
Inputs
popup_shell
Specifies the shell widget to be popped up.
Availability
Release 4 and later.
Description
XtPopupSpringLoaded() calls the functions registered on the specified shell's
XtNpopupCallback callback list and pops the shell up, making it a spring-loaded shell. A spring-loaded shell is one that is popped up in
response to a button press and will pop down when the button is released. Spring-loaded shells have events dispatched to them specially to
ensure that they receive the button up event, even if it occurs in another window. See XtAddGrab() for more details.
XtPopupSpringLoaded() performs exactly like XtPopup(), except that XtPopupSpringLoaded() does the following:
o Sets the shell spring_loaded field to True.
o Always calls XtAddGrab() with exclusive set to True and spring_loaded set to True.
See XtPopup() for details.
Usage
You can also pop up spring loaded shells by using the XtMenuPopup action in a translation table. This predefined action calls XtPopup-
SpringLoaded().
Any pop up shell can be popped down with XtPopdown(), the XtCallbackPopdown() callback function, or with the XtMenuPopdown action.
XtPopupSpringLoaded() was added in Release 4, and prior to this release, the only way to pop up a spring loaded shell was to use the
MenuPopup action (which has now been renamed XtMenuPopup).
See Also
XtAddGrab(1), XtCreatePopupShell(1), XtMenuPopdown(1), XtMenuPopup(1), XtPopdown(1), XtPopup(1).
Xt - Pop Ups XtPopupSpringLoaded()
