XtPopdown(3Xt) MIT X11R4 XtPopdown(3Xt)
Name
XtPopdown, XtCallbackPopdown, MenuPopdown - unmap a pop-up
Syntax
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;
Arguments
call_data Specifies the callback data, which is not used by this procedure.
client_data
Specifies a pointer to the 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 function performs the following:
o Calls to ensure popup_shell is a subclass of
o Checks that popup_shell is currently popped_up; otherwise, it generates an error.
o Unmaps popup_shell's window.
o If popup_shell's grab_kind is either or it calls
o Sets pop-up shell's popped_up field to
o Calls the callback procedures on the shell's popdown_callback list.
The function casts the client data parameter to an 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.
calls with the specified shell_widget and then calls to resensitize the enable_widget.
If a shell name is not given, calls with the widget for which the translation is specified. If a shell_name is specified in the transla-
tion table, 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 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 Window System Toolkit: The Complete Programmer's Guide and Specification, Paul J. Asente and Ralph Swick
X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys
XtPopdown(3Xt)
