XtCreatePopupShell(3)      XT FUNCTIONS     XtCreatePopupShell(3)



NAME
       XtCreatePopupShell, XtVaCreatePopupShell - create a popup
       shell

SYNTAX
       Widget XtCreatePopupShell(String name, WidgetClass wid-
              get_class, Widget parent, ArgList args, Cardinal
              num_args);

       Widget XtVaCreatePopupShell(String name, WidgetClass wid-
              get_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 argu-
                 ment list.

       parent    Specifies the parent widget.

       widget_class
                 Specifies the widget class pointer for the cre-
                 ated shell widget.

       ...       Specifies the variable 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 cur-
       rently 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



X Version 11               libXt 1.0.5      XtCreatePopupShell(3)