ultrix man page for xtpopdown

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)