xtpopupspringloaded(1) [hpux man page]
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()
Check Out this Related Man Page
XtMenuPopup() XtMenuPopup() Name XtMenuPopup - built-in action for popping up a widget. Synopsis (Translation Table) <Event sequence>: XtMenuPopup(shell_name) Inputs shell_name Specifies the name of the widget shell to pop up. Availability This action is named MenuPopup prior to Release 4. Description XtMenuPopdown is a predefined action procedure which does not have a corresponding public C routine. It can only be invoked from a trans- lation table. XtMenuPopup tries to find the named shell by searching the widget tree starting at the widget in which it is invoked. If it finds a shell with the specified name in the popup children of that widget, it pops up the shell with the appropriate parameters. Otherwise, it moves up the parent chain to find a popup child with the specified name. If XtMenuPopup gets to the application top-level shell widget and has not found a matching shell, it generates a warning and returns immediately. If XtMenuPopup is invoked on ButtonPress, it calls XtPopupSpringLoaded() on the specified shell widget. If XtMenuPopup is invoked on Key- Press or EnterWindow, it calls XtPopup() on the specified shell widget with grab_kind set to XtGrabNonexclusive. Otherwise, the transla- tion manager generates a warning message and ignores the action. XtMenuPopup is specially registered with the translation manager as an action that will invoke a grab. This registration is done by call- ing XtRegisterGrabAction() specifying owner_events True, event_mask ButtonPressMask ButtonReleaseMask, and pointer_mode and keyboard_mode GrabModeAsync. Usage Note that XtMenuPopup is an action procedure; you cannot call it from C code. MenuPopup is a synonym for XtMenuPopup. Popup shells can also be popped up explicitly using XtPopup(), XtPopupSpringLoaded() or one of the predefined popup callback procedures (see XtCallbackExclusive()). The action XtMenuPopdown can be used to pop down a shell widget from a translation table. See Also XtMenuPopdown(1), XtPopDown(1), XtPopup(1), XtPopupSpringLoaded(1), XtRegisterGrabAction(1). Xt - Pop Ups XtMenuPopup()