XtCreatePopupShell(3Xt)     X Version 11(Release 3)     XtCreatePopupShell(3Xt)


NAME
      XtCreatePopupShell - 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;

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.

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











10/89                                                                    Page 1