Name

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

Synopsis

void XtMenuPopdown(shell_name)

   String shell_name;

Arguments

shell_name
Specifies the name of the widget shell to pop down.

Description

Pop-ups can be popped down through several mechanisms:

•A call to XtPopdown

•The supplied callback procedure XtCallbackPopdown

•The standard translation action XtMenuPopdown

To pop down a spring-loaded menu when a pointer button is released or when the pointer is moved into some window, use XtMenuPopdown (or its synonym, MenuPopdown). 

XtMenuPopdown is known to the Translation Manager, which must perform special actions for spring-loaded pop ups.  All that is necessary is to map XtMenuPopdown to some event or event sequence using a translation specification in a resource file.  Calls to XtMenuPopdown in a translation specification are mapped into calls to a nonexported action procedure. 

If a shell name is not given as an argument, XtMenuPopdown calls XtPopdown with the widget for which the translation is specified.  If a shell_name is specified in the translation table, XtMenuPopdown tries to find the 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 pop-up children of that parent, it pops down the shell; 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. 

See Also

XtCallbackPopdown(1), XtMenuPopup(1), XtPopDown(1), XtPopup(1), XtPopupSpringLoaded(1).