XtPopupSpri(3x) — HP-UX ANSI C A.10.11

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:

•Sets the shell spring_loaded field to True.

•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 XtPopupSpringLoaded(). 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).

Museum