MirOS Manual: MenuPopdown(3), XtCallbackPopdown(3), XtPopdown(3)


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

NAME

     XtPopdown, XtCallbackPopdown - unmap a pop-up

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

     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.

SEE ALSO

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

XFree86                   Version 4.5.0                         2

Generated on 2017-04-03 16:26:17 by $MirOS: src/scripts/roff2htm,v 1.88 2017/01/29 00:51:06 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002–2017 The MirOS Project, Germany.
This product includes material provided by mirabilos.

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