NAME

TransientShell widget class − popup shell that interacts with the window manager. 

SYNOPSIS

Public Headers:<X11/StringDefs.h>
<X11/Shell.h>

Private Header:<X11/ShellP.h>

Class Name:TransientShell

Class Hierarchy:Core → Composite → Shell → WmShell → VendorShell → TransientShell

Class Pointer:transientShellWidgetClass

Instantiation:widget = XtCreatePopupShell(name,
                   transientShellWidgetClass, ...)

Functions/Macros:XtIsTransientShell()

DESCRIPTION

TransientShell is a subclass of VendorShell that is used for popup shell widgets, such as dialog boxes, that don’t bypass window management.  Most window managers will not allow the user to iconify a TransientShell window on its own, and may iconify it automatically if the window that it is transient for is iconified.  If you want a shell that can be iconified, use TopLevelShell.  If you want a shell independent of the window manager, use OverrideShell. 

NEW RESOURCES

TransientShell defines the following resources:

XtNtransientFor
The widget from which the TransientShell will pop up or some other widget that the TransientShell is logically "transient for." The window of this widget will be stored in the WM_TRANSIENT_FOR property on the TransientShell window, where it can be used by ICCCM-compliant window managers.  If the value of this resource is NULL or identifies an unrealized widget, then TransientShell uses the value of the WMShell resource XtNwindowGroup. 

INHERITED RESOURCES

TransientShell inherits the following resources.  The resources are listed alphabetically, along with the superclass that defines them.  TransientShell sets the resources XtNtransient and XtNsaveUnder to True. 

CLASS STRUCTURE

The TransientShell class structure contains only an extension field: typedef struct {  XtPointer extension; /∗ pointer to extension record ∗/ } TransientShellClassPart;
 
typedef struct _TransientShellClassRec {  CoreClassPart core_class;  CompositeClassPart composite_class;  ShellClassPart shell_class;  WMShellClassPart wm_shell_class;  VendorShellClassPart vendor_shell_class;  TransientShellClassPart transient_shell_class; } TransientShellClassRec; There is no extension defined for TransientShell, and the extension field should be NULL. 

INSTANCE STRUCTURE

The TransientShell instance structure contains at least the following fields (which need not be in this order): typedef struct {  Widget transient_for; } TransientShellPart;
 
typedef struct { CorePart core;  CompositePart composite;  ShellPart shell;  WMShellPart wm;  VendorShellPart vendor;  TransientShellPart transient; } TransientShellRec, ∗TransientShellWidget;

SEE ALSO

ShellUNIX SYSTEM V/68 and V/88 Release 4 TopLevelShellUNIX SYSTEM V/68 and V/88 Release 4, WMShellUNIX SYSTEM V/68 and V/88 Release 4.