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.
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.
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 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 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‒2011 The MirOS Project, Germany.
This product includes material
provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.