XtPopdown()XtPopdown()NameXtPopdown - unmap a popup shell.
Synopsis
void XtPopdown(popup_shell)
Widget popup_shell;
Inputs
popup_shell
Specifies the widget shell to pop down.
DescriptionXtPopdown() pops down a popup shell and calls the functions registered
on the shell's
XtNpopdownCallback list. The "Algorithm" section below explains the
details of this process.
Usage
The Intrinsics also provide other convenience routines to pop down a
popup shell. To perform a pop down from a callback list, register the
function XtCallbackPopdown(). To do so from a translation table, use
the action XtMenuPopdown.
Popup shell widgets can be created with XtCreatePopupShell(), and can
be popped up with XtPopup() or XtPopupSpringLoaded(), or with one of
the built-in callback functions (XtCallbackExclusive(), XtCallbac‐
kNonexclusive(), or XtCallbackNone()), or with the built-in action
XtMenuPopup.
AlgorithmXtPopdown() performs the following:
· Calls XtCheckSubclass() to ensure popup_shell's class is a subclass
of shellWidgetClass.
· Checks that the popped_up field of popup_shell is True; otherwise,
it returns immediately.
· Unmaps popup_shell's window and, if override_redirect is False,
sends a synthetic UnmapNotify event as specified by the Inter-Client
Communications Conventions Manual.
· If popup_shell's grab_kind is either XtGrabNonexclusive or XtGrabEx‐
clusive, it calls XtRemoveGrab().
· Sets popup_shell's popped_up field to False.
· Calls the callback procedures on the shell's popdown_callback list,
specifying a pointer to the value of the shell's grab_kind field as
the call_data argument.
See AlsoXtCallbackPopdown(1), XtCreatePopupShell(1), XtMenuPopdown(1),
XtPopup(1), XtPopupSpringLoaded(1), XtRemoveGrab(1).
Xt - Pop Ups XtPopdown()
