XtPopdown(3Xt)                                     XtPopdown(3Xt)



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

SYNOPSIS
     void XtPopdown(popup-shell)
     Widget popup-shell;

     void XtCallbackPopdown(w, client-data, call-data)
     Widget w;
     XtPointer client-data;
     XtPointer call-data;

     void MenuPopdown(shell-name)
     String shell-name;

DESCRIPTION
     The XtPopdown function performs these operations:

          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 the window of popup-shell.

          If the grab_kind of popup-shell is either
          XtGrabNonexclusive or XtGrabExclusive, it calls XtRemo-
          veGrab.

          Sets the popped_up member of popup-shell to FALSE.

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

     The XtCallbackPopdown function casts client-data 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.

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





November, 1990                                                  1

XtPopdown(3Xt)                                     XtPopdown(3Xt)



     If shell-name is not given, MenuPopdown calls XtPopdown with
     the widget for which the translation is specified.  If
     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.

   Arguments
     These functions accept the following 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.

SEE ALSO
     XtCreatePopupShell(3Xt), XtPopup(3Xt)

     X Toolkit Intrinsics - C Language Interface

     Xlib - C Language Interface





















2                                                  November, 1990