TopLevelShell

NAME

TopLevelShell - The TopLevelShell widget class

SYNOPSIS

#include <Xm/Xm.h>
#include <X11/Shell.h>

DESCRIPTION

TopLevelShell is used for normal top-level windows such as any additional top-level widgets an application needs.

Classes

TopLevelShell inherits behavior and resources from Core, Composite, Shell, WMShell, and VendorShell.

The class pointer is topLevelShellWidgetClass.

The class name is TopLevelShell.

New Resources

The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a .Xdefaults file, remove the XmN or XmC prefix and use the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove the Xm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using XtSetValues (S), retrieved by using XtGetValues (G), or is not applicable (N/A).


TopLevelShell Resource Set
Name                 Class                Type     Default  Access
XmNiconic            XmCIconic            Boolean  False    CSG
XmNiconName          XmCIconName          String   NULL     CSG
XmNiconNameEncoding  XmCIconNameEncoding  Atom     dynamic  CSG

**TopLevelShell Resource Set**
Name	Class	Type	Default	Access
XmNiconic	XmCIconic	Boolean	False	CSG
XmNiconName	XmCIconName	String	NULL	CSG
XmNiconNameEncoding	XmCIconNameEncoding	Atom	dynamic	CSG

XmNiconic: Specifies that if this is True when the widget instance is realized, the widget instance indicates to the window manager that the application wishes to start as an icon, irrespective of the XmNinitialState resource.
XmNiconName: Specifies the short form of the application name to be displayed by the window manager when the application is iconified.
XmNiconNameEncoding: Specifies a property type that represents the encoding of the XmNiconName string. If a language procedure has been set, the default is None; otherwise, the default is XA_STRING. When the widget is realized, if the value is None, the corresponding name is assumed to be in the current locale. The name is passed to XmbTextListToTextProperty with an encoding style of XStdICCTextStyle. The resulting encoding is "STRING" if the name is fully convertible to "STRING," otherwise "COMPOUND_TEXT." The values of the encoding resources are not changed; they remain None.

Inherited Resources

TopLevelShell inherits behavior and resources from the following superclasses. For a complete description of each resource, refer to the man page for that superclass.


VendorShell Resource Set
Name                    Class                   Type           Default     Access
XmNaudibleWarning       XmCAudibleWarning       unsigned char  XmBELL      CSG
XmNbuttonFontList       XmCButtonFontList       XmFontList     dynamic     CSG
XmNdefaultFontList      XmCDefaultFontList      XmFontList     dynamic     CG
XmNdeleteResponse       XmCDeleteResponse       unsigned char  XmDESTROY   CSG
XmNinputMethod          XmCInputMethod          String         NULL        CSG
XmNkeyboardFocusPolicy  XmCKeyboardFocusPolicy  unsigned char  XmEXPLICIT  CSG
XmNlabelFontList        XmCLabelFontList        XmFontList     dynamic     CSG
XmNmwmDecorations       XmCMwmDecorations       int            -1          CSG
XmNmwmFunctions         XmCMwmFunctions         int            -1          CSG
XmNmwmInputMode         XmCMwmInputMode         int            -1          CSG
XmNmwmMenu              XmCMwmMenu              String         NULL        CSG
XmNpreeditType          XmCPreeditType          String         dynamic     CSG
XmNshellUnitType        XmCShellUnitType        unsigned char  XmPIXELS    CSG
XmNtextFontList         XmCTextFontList         XmFontList     dynamic     CSG
XmNuseAsyncGeometry     XmCUseAsyncGeometry     Boolean        False       CSG

**VendorShell Resource Set**
Name	Class	Type	Default	Access
XmNaudibleWarning	XmCAudibleWarning	unsigned char	XmBELL	CSG
XmNbuttonFontList	XmCButtonFontList	XmFontList	dynamic	CSG
XmNdefaultFontList	XmCDefaultFontList	XmFontList	dynamic	CG
XmNdeleteResponse	XmCDeleteResponse	unsigned char	XmDESTROY	CSG
XmNinputMethod	XmCInputMethod	String	NULL	CSG
XmNkeyboardFocusPolicy	XmCKeyboardFocusPolicy	unsigned char	XmEXPLICIT	CSG
XmNlabelFontList	XmCLabelFontList	XmFontList	dynamic	CSG
XmNmwmDecorations	XmCMwmDecorations	int	-1	CSG
XmNmwmFunctions	XmCMwmFunctions	int	-1	CSG
XmNmwmInputMode	XmCMwmInputMode	int	-1	CSG
XmNmwmMenu	XmCMwmMenu	String	NULL	CSG
XmNpreeditType	XmCPreeditType	String	dynamic	CSG
XmNshellUnitType	XmCShellUnitType	unsigned char	XmPIXELS	CSG
XmNtextFontList	XmCTextFontList	XmFontList	dynamic	CSG
XmNuseAsyncGeometry	XmCUseAsyncGeometry	Boolean	False	CSG


WMShell Resource Set
Name              Class             Type     Default                Access
XmNbaseHeight     XmCBaseHeight     int      XtUnspecifiedShellInt  CSG
XmNbaseWidth      XmCBaseWidth      int      XtUnspecifiedShellInt  CSG
XmNheightInc      XmCHeightInc      int      XtUnspecifiedShellInt  CSG
XmNiconMask       XmCIconMask       Pixmap   NULL                   CSG
XmNiconPixmap     XmCIconPixmap     Pixmap   NULL                   CSG
XmNiconWindow     XmCIconWindow     Window   NULL                   CSG
XmNiconX          XmCIconX          int      -1                     CSG
XmNiconY          XmCIconY          int      -1                     CSG
XmNinitialState   XmCInitialState   int      NormalState            CSG
XmNinput          XmCInput          Boolean  True                   CSG
XmNmaxAspectX     XmCMaxAspectX     int      XtUnspecifiedShellInt  CSG
XmNmaxAspectY     XmCMaxAspectY     int      XtUnspecifiedShellInt  CSG
XmNmaxHeight      XmCMaxHeight      int      XtUnspecifiedShellInt  CSG
XmNmaxWidth       XmCMaxWidth       int      XtUnspecifiedShellInt  CSG
XmNminAspectX     XmCMinAspectX     int      XtUnspecifiedShellInt  CSG
XmNminAspectY     XmCMinAspectY     int      XtUnspecifiedShellInt  CSG
XmNminHeight      XmCMinHeight      int      XtUnspecifiedShellInt  CSG
XmNminWidth       XmCMinWidth       int      XtUnspecifiedShellInt  CSG
XmNtitle          XmCTitle          String   dynamic                CSG
XmNtitleEncoding  XmCTitleEncoding  Atom     dynamic                CSG
XmNtransient      XmCTransient      Boolean  False                  CSG
XmNwaitForWm      XmCWaitForWm      Boolean  True                   CSG
XmNwidthInc       XmCWidthInc       int      XtUnspecifiedShellInt  CSG
XmNwindowGroup    XmCWindowGroup    Window   dynamic                CSG
XmNwinGravity     XmCWinGravity     int      dynamic                CSG
XmNwmTimeout      XmCWmTimeout      int      5000 ms                CSG

**WMShell Resource Set**
Name	Class	Type	Default	Access
XmNbaseHeight	XmCBaseHeight	int	XtUnspecifiedShellInt	CSG
XmNbaseWidth	XmCBaseWidth	int	XtUnspecifiedShellInt	CSG
XmNheightInc	XmCHeightInc	int	XtUnspecifiedShellInt	CSG
XmNiconMask	XmCIconMask	Pixmap	NULL	CSG
XmNiconPixmap	XmCIconPixmap	Pixmap	NULL	CSG
XmNiconWindow	XmCIconWindow	Window	NULL	CSG
XmNiconX	XmCIconX	int	-1	CSG
XmNiconY	XmCIconY	int	-1	CSG
XmNinitialState	XmCInitialState	int	NormalState	CSG
XmNinput	XmCInput	Boolean	True	CSG
XmNmaxAspectX	XmCMaxAspectX	int	XtUnspecifiedShellInt	CSG
XmNmaxAspectY	XmCMaxAspectY	int	XtUnspecifiedShellInt	CSG
XmNmaxHeight	XmCMaxHeight	int	XtUnspecifiedShellInt	CSG
XmNmaxWidth	XmCMaxWidth	int	XtUnspecifiedShellInt	CSG
XmNminAspectX	XmCMinAspectX	int	XtUnspecifiedShellInt	CSG
XmNminAspectY	XmCMinAspectY	int	XtUnspecifiedShellInt	CSG
XmNminHeight	XmCMinHeight	int	XtUnspecifiedShellInt	CSG
XmNminWidth	XmCMinWidth	int	XtUnspecifiedShellInt	CSG
XmNtitle	XmCTitle	String	dynamic	CSG
XmNtitleEncoding	XmCTitleEncoding	Atom	dynamic	CSG
XmNtransient	XmCTransient	Boolean	False	CSG
XmNwaitForWm	XmCWaitForWm	Boolean	True	CSG
XmNwidthInc	XmCWidthInc	int	XtUnspecifiedShellInt	CSG
XmNwindowGroup	XmCWindowGroup	Window	dynamic	CSG
XmNwinGravity	XmCWinGravity	int	dynamic	CSG
XmNwmTimeout	XmCWmTimeout	int	5000 ms	CSG


Shell Resource Set
Name                     Class                    Type                    Default         Access
XmNallowShellResize      XmCAllowShellResize      Boolean                 False           CG
XmNcreatePopupChildProc  XmCCreatePopupChildProc  XtCreatePopupChildProc  NULL            CSG
XmNgeometry              XmCGeometry              String                  NULL            CSG
XmNoverrideRedirect      XmCOverrideRedirect      Boolean                 False           CSG
XmNpopdownCallback       XmCCallback              XtCallbackList          NULL            C
XmNpopupCallback         XmCCallback              XtCallbackList          NULL            C
XmNsaveUnder             XmCSaveUnder             Boolean                 False           CSG
XmNvisual                XmCVisual                Visual *                CopyFromParent  CSG

**Shell Resource Set**
Name	Class	Type	Default	Access
XmNallowShellResize	XmCAllowShellResize	Boolean	False	CG
XmNcreatePopupChildProc	XmCCreatePopupChildProc	XtCreatePopupChildProc	NULL	CSG
XmNgeometry	XmCGeometry	String	NULL	CSG
XmNoverrideRedirect	XmCOverrideRedirect	Boolean	False	CSG
XmNpopdownCallback	XmCCallback	XtCallbackList	NULL	C
XmNpopupCallback	XmCCallback	XtCallbackList	NULL	C
XmNsaveUnder	XmCSaveUnder	Boolean	False	CSG
XmNvisual	XmCVisual	Visual *	CopyFromParent	CSG


Composite Resource Set
Name               Class              Type         Default  Access
XmNchildren        XmCReadOnly        WidgetList   NULL     G
XmNinsertPosition  XmCInsertPosition  XtOrderProc  NULL     CSG
XmNnumChildren     XmCReadOnly        Cardinal     0        G

**Composite Resource Set**
Name	Class	Type	Default	Access
XmNchildren	XmCReadOnly	WidgetList	NULL	G
XmNinsertPosition	XmCInsertPosition	XtOrderProc	NULL	CSG
XmNnumChildren	XmCReadOnly	Cardinal	0	G


Core Resource Set
Name                           Class                          Type            Default               Access
XmNaccelerators                XmCAccelerators                XtAccelerators  dynamic               CSG
XmNancestorSensitive           XmCSensitive                   Boolean         dynamic               G
XmNbackground                  XmCBackground                  Pixel           dynamic               CSG
XmNbackgroundPixmap            XmCPixmap                      Pixmap          XmUNSPECIFIED_PIXMAP  CSG
XmNborderColor                 XmCBorderColor                 Pixel           XtDefaultForeground   CSG
XmNborderPixmap                XmCPixmap                      Pixmap          XmUNSPECIFIED_PIXMAP  CSG
XmNborderWidth                 XmCBorderWidth                 Dimension       1                     CSG
XmNcolormap                    XmCColormap                    Colormap        dynamic               CG
XmNdepth                       XmCDepth                       int             dynamic               CG
XmNdestroyCallback             XmCCallback                    XtCallbackList  NULL                  C
XmNheight                      XmCHeight                      Dimension       dynamic               CSG
XmNinitialResourcesPersistent  XmCInitialResourcesPersistent  Boolean         True                  C
XmNmappedWhenManaged           XmCMappedWhenManaged           Boolean         True                  CSG
XmNscreen                      XmCScreen                      Screen *        dynamic               CG
XmNsensitive                   XmCSensitive                   Boolean         True                  CSG
XmNtranslations                XmCTranslations                XtTranslations  dynamic               CSG
XmNwidth                       XmCWidth                       Dimension       dynamic               CSG
XmNx                           XmCPosition                    Position        0                     CSG
XmNy                           XmCPosition                    Position        0                     CSG

**Core Resource Set**
Name	Class	Type	Default	Access
XmNaccelerators	XmCAccelerators	XtAccelerators	dynamic	CSG
XmNancestorSensitive	XmCSensitive	Boolean	dynamic	G
XmNbackground	XmCBackground	Pixel	dynamic	CSG
XmNbackgroundPixmap	XmCPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
XmNborderColor	XmCBorderColor	Pixel	XtDefaultForeground	CSG
XmNborderPixmap	XmCPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
XmNborderWidth	XmCBorderWidth	Dimension	1	CSG
XmNcolormap	XmCColormap	Colormap	dynamic	CG
XmNdepth	XmCDepth	int	dynamic	CG
XmNdestroyCallback	XmCCallback	XtCallbackList	NULL	C
XmNheight	XmCHeight	Dimension	dynamic	CSG
XmNinitialResourcesPersistent	XmCInitialResourcesPersistent	Boolean	True	C
XmNmappedWhenManaged	XmCMappedWhenManaged	Boolean	True	CSG
XmNscreen	XmCScreen	Screen *	dynamic	CG
XmNsensitive	XmCSensitive	Boolean	True	CSG
XmNtranslations	XmCTranslations	XtTranslations	dynamic	CSG
XmNwidth	XmCWidth	Dimension	dynamic	CSG
XmNx	XmCPosition	Position	0	CSG
XmNy	XmCPosition	Position	0	CSG

Translations

There are no translations for TopLevelShell.

RELATED INFORMATION

Composite(3X), Core(3X), Shell(3X), WMShell(3X), and VendorShell(3X).