Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

XtCreateWidget(3Xt)

XtPopdown(3Xt)

XtPopup(3Xt)

XtCreatePopupShell(3Xt)              SysV              XtCreatePopupShell(3Xt)



NAME
     XtCreatePopupShell

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

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026