MenuPopdown


NAME

XtPopdown, XtCallbackPopdown - 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 XtPopdownID struc- ture. 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; oth- erwise, it generates an error. o Unmaps popup_shell's window. o If popup_shell's grab_kind is either XtGrabNonexclu- sive 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 pop- down_callback list. The XtCallbackPopdown function casts the client data parameter to an XtPopdownID 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. 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, MenuPopdown tries to find the shell by looking up the wid- get 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(3), XtPopup(3) X Toolkit Intrinsics - C Language Interface Xlib - C Language X Interface

Man(1) output converted with man2html