hpux man page for xtcreatepob

XtCreatePopupShell()													      XtCreatePopupShell()

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

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 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 gen-
  erally 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 Also
  XtCallbackExclusive(1), XtMenuPopup(1), XtPopdown(1), XtPopup(1), XtVaCreatePopupShell(1).

Xt - Pop Ups														      XtCreatePopupShell()