NAME

XtPopdown − unmap a popup shell. 

Synopsis

void XtPopdown(popup_shell)

    Widget popup_shell;

Inputs

popup_shell
Specifies the widget shell to pop down.

Description

XtPopdown() 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(), XtCallbackNonexclusive(), or XtCallbackNone()), or with the built-in action XtMenuPopup. 

Algorithm

XtPopdown() 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 XtGrabExclusive, 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 Also

XtCallbackPopdown(1), XtCreatePopupShell(1), XtMenuPopdown(1), XtPopup(1), XtPopupSpringLoaded(1), XtRemoveGrab(1). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates