Name

XtPopdown — unmap a pop-up shell. 

Synopsis

void XtPopdown(popup_shell)

    Widget popup_shell;

Arguments

popup_shell
Specifies the widget shell to pop down.

Description

XtPopdown pops down a pop-up shell that was popped up by XtPopup or XtPopupSpringLoaded, by one of the built-in callback functions (XtCallbackExclusive, XtCallbackNonexclusive, or XtCallbackNone), or by the built-in action function XtMenuPopup. 

To perform a pop down from a callback list, use XtCallbackPopdown.  To do so from a translation table, use XtMenuPopdown. 

XtPopdown performs the following:

•Calls XtCheckSubclass to ensure popup_shell is a subclass of Shell. 

•Checks that popup_shell is currently popped_up; otherwise, it generates an error. 

•Unmaps popup_shell’s window. 

•If popup_shell’s grab_kind is either XtGrabNonexclusive or XtGrabExclusive, it calls XtRemoveGrab.  The grab kind is specified as an argument to XtPopup. 

•Sets popup_shell’s popped_up field to False. 

•Calls the callback procedures on the shell’s popdown_callback list, designated by the resource XtNpopdownCallback.  (See XtCreatePopupShell.) 

Pop-up shell widgets can be created with XtCreatePopupShell.  For more information, see Chapter 12, Menus, Gadgets, and Cascaded Pop Ups, in Volume Four, X Toolkit Intrinsics Programming Manual. 

See Also

XtCallbackPopdown(1), XtCheckSubclass(1), XtCreatePopupShell(1), XtMenuPopdown(1), XtRemoveGrab(1).