XtMenuPopup()XtMenuPopup()NameXtMenuPopup - 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 transla‐
tion 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 XtPopup‐
SpringLoaded() on the specified shell widget. If XtMenuPopup is
invoked on KeyPress or EnterWindow, it calls XtPopup() on the specified
shell widget with grab_kind set to XtGrabNonexclusive. Otherwise, the
translation 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 calling
XtRegisterGrabAction() specifying owner_events True, event_mask Button‐
PressMask ButtonReleaseMask, and pointer_mode and keyboard_mode Grab‐
ModeAsync.
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(), XtPopup‐
SpringLoaded() 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 AlsoXtMenuPopdown(1), XtPopDown(1), XtPopup(1), XtPopupSpringLoaded(1),
XtRegisterGrabAction(1).
Xt - Pop Ups XtMenuPopup()