MenuPopup(3X) — DeltaWindows 1.3.3 Release 4 Version 4.3

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 translation 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 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 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.