XtMenuPopdo(3x) — HP-UX 9.05

NAME

XtMenuPopdown − built-in action for popping down a widget.

Synopsis (Translation Table)

<Event sequence>: XtMenuPopdown([shell])

Inputs

shellAn optional argument which specifies the name of the shell to pop down.

Availability

This action is named MenuPopdown 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. If passed an argument, that argument is interpreted as a shell name, and XtMenuPopdown tries to find the named shell by looking up the widget tree starting at the parent of the widget in which it is invoked. If it finds a shell with the specified name in the popup children of that parent, it pops down the shell by calling XtPopdown(); otherwise, it moves up the parent chain as needed. If XtMenuPopdown gets to the application top-level shell widget and cannot find a matching shell, it generates a warning and returns immediately. If XtMenuPopdown is called with no argument, it calls XtPopdown() on the widget for which the translation is specified.

Usage

Note that XtMenuPopdown is an action procedure; you cannot call it from C code. The action name MenuPopdown is a synonym for XtMenuPopdown. Either action can be used to pop down menus or other popup shells. Popup shells can also be popped down by calling XtPopdown() explicitly, or by using the predefined callback procedure XtCallbackPopdown(). The action XtMenuPopup can be used to pop up a spring-loaded popup from a translation table.

Museum