XtCreatePopupShell(3Xt)

     NAME
          XtCreatePopupShell, XtVaCreatePopupShell - create a popup
          shell

     SYNTAX
          Widget XtCreatePopupShell(name, widget_class, parent, args,
          num_args)
                String name;
                WidgetClass widget_class;
                Widget parent;
                ArgList args;
                Cardinal num_args;

          Widget XtVaCreatePopupShell(name, widget_class, parent, ...)
                String name;
                WidgetClass widget_class;
                Widget parent;

     ARGUMENTS
          args      Specifies the argument list to override the
                    resource defaults.

          name      Specifies the text name for the created shell
                    widget.

          num_args  Specifies the number of arguments in the argument
                    list.

          parent    Specifies the parent widget.

          widget_class
                    Specifies the widget class pointer for the created
                    shell widget.

          ...       Specifies the NULL-terminated variable-length
                    argument list to override the resource defaults.

     DESCRIPTION
          The XtCreatePopupShell function ensures that the specified
          class is a subclass of Shell and, rather than using
          insert_child to attach the widget to the parent's children
          list, attaches the shell to the parent's pop-ups list
          directly.

          A spring-loaded pop-up invoked from a translation table
          already must exist at the time that the translation is
          invoked, so the translation manager can find the shell by
          name.  Pop-ups invoked in other ways can be created ``on-
          the-fly'' when the pop-up actually is needed.  This delayed
          creation of the shell is particularly useful when you pop up
          an unspecified number of pop-ups.  You can look to see if an
          appropriate unused shell (that is, not currently popped up)
          exists and create a new shell if needed.

     SEE ALSO
          XtCreateWidget(3Xt), XtPopdown(3Xt), XtPopup(3Xt)
          X Toolkit Intrinsics - C Language Interface
          Xlib - C Language X Interface