XtCreatePoB(3x) — HP-UX ANSI C A.10.11

NAME

XtCreatePopupShell − 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

nameSpecifies 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.

parentSpecifies the parent widget; must be of class Core or any subclass thereof.

argsSpecifies the argument list to override the resource defaults.

num_argsSpecifies the number of arguments in the argument list.

Returns

A widget of class widget_class created as a popup child of parent.

Description

XtCreatePopupShell() 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 determined, 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 predefined 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.

Museum