SYNTAX

       void XtPopdown(Widget popup_shell);

       void XtCallbackPopdown(Widget w, XtPointer client_data, XtPointer
              call_data);

       void MenuPopdown(String shell_name);

ARGUMENTS

       call_data Specifies the callback data, which is not used by this proce-
                 dure.

       client_data
                 Specifies a pointer to the XtPopdownID structure.

       popup_shell
                 Specifies the widget shell to pop down.

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

       w         Specifies the widget.

DESCRIPTION

       The XtPopdown function performs the following:

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

       o    Checks that popup_shell is currently popped_up; otherwise, it gen-
            erates an error.

       o    Unmaps popup_shell's window.

       o    If popup_shell's grab_kind is either XtGrabNonexclusive or
            XtGrabExclusive, it calls XtRemoveGrab.

       o    Sets pop-up shell's popped_up field to False.

       o    Calls the callback procedures on the shell's popdown_callback
            list.

       The XtCallbackPopdown function casts the client data parameter to an
       XtPopdownID pointer:

       typedef struct {
            Widget shell_widget;
            Widget enable_widget;
       } XtPopdownIDRec, *XtPopdownID;
The shell_widget is the pop-up shell to pop down, and the enable_widget is the
widget that was used to pop it up.

       XtCreatePopupShell(3Xt), XtPopup(3Xt)
       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface



X Version 11                      Release 6.6                   XtPopdown(3Xt)