XtCreatePopupShell(3Xt) MIT X11R4 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 function ensures that the specified class is a subclass of 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 appropri-
ate 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 Window System Toolkit: The Complete Programmer's Guide and Specification, Paul J. Asente and Ralph Swick
X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys
XtCreatePopupShell(3Xt)
