XtCreatePopupShell()XtCreatePopupShell()NameXtCreatePopupShell - create a popup shell widget.
Synopsis
Widget XtCreatePopupShell(name, widget_class, parent, args, num_args)
String name;
WidgetClass widget_class;
Widget parent;
ArgList args;
Cardinal num_args;
Inputs
name Specifies the resource name for the created shell widget.
widget_class
Specifies the widget class pointer for the created shell
widget; must be shellClass or any subclass.
parent Specifies the parent widget; must be of class Core or any
subclass thereof.
args Specifies the argument list to override the resource
defaults.
num_args Specifies the number of arguments in the argument list.
Returns
A widget of class widget_class created as a popup child of parent.
DescriptionXtCreatePopupShell() checks that widget_class is a subclass of Shell,
and, if it is, creates a widget of that class. The widget is not
stored in the children array (maintained by Composite widgets), but
rather in the popup_list array (which all widgets have).
The screen resource for this widget is determined by first scanning
args for the XtNscreen resource. If it is not found, the resource
database associated with the parent's screen is queried. If both
queries fail, the parent's screen is used. Once the screen is deter‐
mined, the resource database associated with that screen is used to
retrieve all remaining resources for the widget not specified in args.
Usage
All shell widgets other than those created by XtAppInitialize() and
XtAppCreateShell() must be created with XtCreatePopupShell(). Popup
shells can be a child of any widget, not just Composite widgets.
Remember that shell widgets can only have a single child, which will
generally be the layout widget that arranges whatever grandchildren
widgets are to appear in the popup.
Creating and realizing a popup shell widget is not enough to make it
visible. To make a shell pop up, use XtPopup() or one of the prede‐
fined callback procedures or menu actions that call this function. To
make it popdown, call XtPopdown().
Rather than initializing an ArgList to pass to XtCreatePopupShell(),
you can call XtVaCreatePopupShell() which accepts a NULL-terminated
variable length argument list of resource names and resource values.
See AlsoXtCallbackExclusive(1), XtMenuPopup(1), XtPopdown(1), XtPopup(1),
XtVaCreatePopupShell(1).
Xt - Pop Ups XtCreatePopupShell()
