Manual Pages for UNIX Operating System command usage for man XtPopdown

XT FUNCTIONS                                       XtPopdown(3xt)



NAME
     XtPopdown, XtCallbackPopdown - unmap a pop-up

SYNTAX
     cc [ flag... ] file... -lXt [ library... ]

     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 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:

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

     +o    Checks that popup_shell is currently popped_up; other-
          wise, it generates 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 parame-
     ter to an XtPopdownID pointer:





X Version 11        Last change: libXt 1.0.8                    1






XT FUNCTIONS                                       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


ATTRIBUTES
     See attributes(5) for descriptions of the following attri-
     butes:

     __________________________________________________________________
    |       ATTRIBUTE TYPE        |          ATTRIBUTE VALUE          |
    |_____________________________|___________________________________|
    | Availability                | x11/library/toolkit/libxt         |
    |_____________________________|___________________________________|
    | Interface Stability         | Committed                         |
    |_____________________________|___________________________________|
    | MT-Level                    | See XtToolkitThreadInitialize(3XT)|
    |_____________________________|___________________________________|














X Version 11        Last change: libXt 1.0.8                    2