XtPopdown(3Xt)                                     XtPopdown(3Xt)



NAME
     XtPopdown, XtCallbackPopdown, MenuPopdown - unmap a pop-up

SYNTAX
     void XtPopdown(popup_shell)
           Widget popup_shell;

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

     void MenuPopdown(shell_name)
           String shell_name;

ARGUMENTS
     call_data Specifies the callback data, which is not used by
               this procedure.

     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:

     ⊕    Calls XtCheckSubclass to ensure popup_shell is a sub-
          class of Shell.

     ⊕    Checks that popup_shell is currently popped_up; other-
          wise, it generates an error.

     ⊕    Unmaps popup_shell's window.

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

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

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

     The XtCallbackPopdown function casts the client data parame-
     ter to an XtPopdownID pointer:



XWIN 3.0               Last change: 9/1/88                 .ie t

XtPopdown(3Xt)                                     XtPopdown(3Xt)



     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.

     XtCallbackPopdown calls XtPopdown with the specified
     shell_widget and then calls XtSetSensitive to resensitize
     the enable_widget.

     If a shell name is not given, MenuPopdown calls XtPopdown
     with the widget for which the translation is specified.  If
     a shell_name is specified in the translation table, MenuPop-
     down 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 MenuPopdown gets
     to the application top-level shell widget and cannot find a
     matching shell, it generates an error.

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





























XWIN 3.0               Last change: 9/1/88                 .ie t

XtPopdown(3Xt)                                     XtPopdown(3Xt)























































XWIN 3.0               Last change: 9/1/88                 .ie t