xtcreatepob(3) [hpux man page]
XtCreatePopupShell() XtCreatePopupShell() Name XtCreatePopupShell - create a popup shell widget. Synopsis Widget XtCreatePopupShell(name, widget_class, parent, args, num_args) String name; WidgetClass widget_class; Widget parent; ArgList args; Cardinal num_args; Inputs name Specifies the resource name for the created shell widget. widget_class Specifies the widget class pointer for the created shell widget; must be shellClass or any subclass. parent Specifies the parent widget; must be of class Core or any subclass thereof. args Specifies the argument list to override the resource defaults. num_args Specifies the number of arguments in the argument list. Returns A widget of class widget_class created as a popup child of parent. Description XtCreatePopupShell() checks that widget_class is a subclass of Shell, and, if it is, creates a widget of that class. The widget is not stored in the children array (maintained by Composite widgets), but rather in the popup_list array (which all widgets have). The screen resource for this widget is determined by first scanning args for the XtNscreen resource. If it is not found, the resource database associated with the parent's screen is queried. If both queries fail, the parent's screen is used. Once the screen is deter- mined, the resource database associated with that screen is used to retrieve all remaining resources for the widget not specified in args. Usage All shell widgets other than those created by XtAppInitialize() and XtAppCreateShell() must be created with XtCreatePopupShell(). Popup shells can be a child of any widget, not just Composite widgets. Remember that shell widgets can only have a single child, which will gen- erally be the layout widget that arranges whatever grandchildren widgets are to appear in the popup. Creating and realizing a popup shell widget is not enough to make it visible. To make a shell pop up, use XtPopup() or one of the prede- fined callback procedures or menu actions that call this function. To make it popdown, call XtPopdown(). Rather than initializing an ArgList to pass to XtCreatePopupShell(), you can call XtVaCreatePopupShell() which accepts a NULL-terminated variable length argument list of resource names and resource values. See Also XtCallbackExclusive(1), XtMenuPopup(1), XtPopdown(1), XtPopup(1), XtVaCreatePopupShell(1). Xt - Pop Ups XtCreatePopupShell()
Check Out this Related Man Page
XtAppCreateShell() XtAppCreateShell() Name XtAppCreateShell - create a shell widget at the root of a widget tree. Synopsis Widget XtAppCreateShell(application_name, application_class, widget_class, display, args, num_args) String application_name; String application_class; WidgetClass widget_class; Display *display; ArgList args; Cardinal num_args; Inputs application_name Specifies the resource name of the shell widget, or NULL. application_class Specifies the resource class to be used for the shell widget if it is of applicationShellWidgetClass or a subclass thereof. widget_class Specifies the widget class of the created widget. (normally applicationShellWidgetClass). display Specifies the display on which the shell is to be created. args Specifies the argument list to override other resource specifications. num_args Specifies the number of arguments in the argument list. Description XtAppCreateShell() creates a shell widget of class widget_class on display display. The created widget has no parent-it is at the root of a widget tree and at the top of the resource name hierarchy. The resource name of the widget is either application_name, or, if that is NULL, the name that was passed to XtDisplayInitialize() or XtOpenDisplay() when the display was initialized. The resource class of the widget is either application_class, if the widget_class is applicationShellWidgetClass or a subclass, or the normal class name of the wid- get otherwise. The widget is created on the screen specified by the XtNscreen resource or on the default screen of display if no such resource is found. In X11R4, the XtNscreen and other resources are all obtained from args and from the database of display. In X11R5, however, there is a resource database for each screen of a display, and the resources for the created shell widget are obtained somewhat differently: the argu- ment list args is first scanned for a resource named XtNscreen, and if none is found, the database of the default screen of display is searched for this resource. If the XtNscreen resource is found the database from the specified screen is used for all the remaining resources of the widget. If the XtNscreen resource is not found, the database of the default screen continues to be used. In either case, the resources in args override values in the database. Usage Most applications can simply use XtAppInitialize() which initializes the toolkit, creates an application context, opens a display, and then calls XtAppCreateShell() to create a shell on that display. An application that wishes to have multiple toplevel windows on the same screen (a mail reader and a mail composer, for example) should generally use XtCreatePopupShell() to create additional shells within the widget tree and resource hierarchy of the original shell. Creat- ing multiple root shells with different names is generally not a good idea because then your application will have resources specified under several different hierarchies. It is sometimes useful to create multiple root shells with the same name, however, if your applica- tion is capable of creating multiple instances of itself. Each of these instances will find the same resources in the same database and will appear to be "clones" of each other. To create shells on multiple displays, open each display with XtOpenDisplay() and use the resulting Display * in a call to XtAppCre- ateShell(). If all displays are initialized in the same application context, then all events will be correctly handled by XtAppMainLoop(). XtAppCreateShell() can also be used to create toplevel shells on multiple screens. Note that prior to X11R5, however, it is not possible to maintain separate resource databases for each screen. The specified widget class for the new shell widget should almost always be applicationShellWidgetClass or some subclass. XtVaAppCreateShell() behaves identically to XtAppCreateShell(), but takes a NULL-terminated variable-length argument list of resource name/resource value pairs rather than an array of Arg. See Also XtAppInitialize(1), XtCreatePopupShell(1), XtDisplayInitialize(1), XtOpenDisplay(1), XtVaAppCreateShell(1). Xt - Initialization XtAppCreateShell()