MirBSD manpage: MenuPopdown(3), XtCallbackPopdown(3), XtPopdown(3)

XtPopdown(3Xt)            XT FUNCTIONS             XtPopdown(3Xt)


     XtPopdown, XtCallbackPopdown - unmap a pop-up


     void XtPopdown(Widget popup_shell);

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

     void MenuPopdown(String shell_name);


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

               Specifies a pointer to the XtPopdownID structure.

               Specifies the widget shell to pop down.

               Specifies the name of the widget shell to pop

     w         Specifies the widget.


     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:

     typedef struct {
          Widget shell_widget;
          Widget enable_widget;

XFree86                   Version 4.5.0                         1

XtPopdown(3Xt)            XT FUNCTIONS             XtPopdown(3Xt)

     } 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.


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

XFree86                   Version 4.5.0                         2

Generated on 2021-12-07 11:07:08 by $MirOS: src/scripts/roff2htm,v 1.103 2021/01/23 20:24:35 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2021 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.