ApplicationShell

ApplicationShell(library call)                  ApplicationShell(library call)



NAME
       ApplicationShell — The ApplicationShell widget class

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

DESCRIPTION
       ApplicationShell is used as the main top-level window for an
       application. An application should have more than one ApplicationShell
       only if it implements multiple logical applications.

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

       The class pointer is applicationShellWidgetClass.

       The class name is ApplicationShell.

   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).

       ┌────────────────────────────────────────────────┐
       │        │ApplicationShell Resource Set │        │
       │Name    Class   Type     Default Access │
       ├────────┼─────────┼──────────┼─────────┼────────┤
       │XmNargc │ XmCArgc │ int      │ 0       │ CSG    │
       ├────────┼─────────┼──────────┼─────────┼────────┤
       │XmNargv │ XmCArgv │ String * │ NULL    │ CSG    │
       ├────────┼─────────┼──────────┼─────────┼────────┤
       └────────┴─────────┴──────────┴─────────┴────────┘
       XmNargc   Specifies the number of arguments given in the XmNargv
                 resource.  The function XtInitialize sets this resource on
                 the shell widget instance it creates by using its parameters
                 as the values.

       XmNargv   Specifies the argument list required by a session manager to
                 restart the application if it is killed. This list should be
                 updated at appropriate points by the application if a new
                 state has been reached that can be directly restarted.  The
                 function XtInitialize sets this resource on the shell widget
                 instance it creates by using its parameters as the values.
                 When XtGetValues is called on this resource, the returned
                 value is a pointer to the actual resource value and should
                 not be freed.

   Inherited Resources
       ApplicationShell inherits behavior and resources from the following
       superclasses. For a complete description of each resource, refer to the
       reference page for that superclass.

       ┌───────────────────────────────────────────────────────────────────────┐
       │                    │ TopLevelShell Resource Set    │         │        │
       │Name                Class               Type    Default Access │
       ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
       │XmNiconic           │ XmCIconic           │ Boolean │ False   │ CSG    │
       ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
       │XmNiconName         │ XmCIconName         │ String  │ NULL    │ CSG    │
       ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
       │XmNiconNameEncoding │ XmCIconNameEncoding │ Atom    │ dynamic │ CSG    │
       ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
       └────────────────────┴─────────────────────┴─────────┴─────────┴────────┘
       ┌───────────────────────────────────────────────────────────────────────────────────────────┐
       │                       │         VendorShell Resource Set       │                 │        │
       │Name                   Class                  Type          Default         Access │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNaudibleWarning      │ XmCAudibleWarning      │ unsigned char │ XmBELL          │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNbuttonFontList      │ XmCButtonFontList      │ XmFontList    │ dynamic         │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNbuttonRenderTable   │ XmCButtonRenderTable   │ XmRenderTable │ dynamic         │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNdefaultFontList     │ XmCDefaultFontList     │ XmFontList    │ dynamic         │ CG     │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNdeleteResponse      │ XmCDeleteResponse      │ unsigned char │ XmDESTROY       │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNinputMethod         │ XmCInputMethod         │ String        │ NULL            │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNinputPolicy         │ XmCInputPolicy         │ XmInputPolicy │ XmPER_SHELL     │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNkeyboardFocusPolicy │ XmCKeyboardFocusPolicy │ unsigned char │ XmEXPLICIT      │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNlabelFontList       │ XmCLabelFontList       │ XmFontList    │ dynamic         │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNlabelRenderTable    │ XmCLabelRenderTabel    │ XmRenderTable │ dynamic         │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNlayoutDirection     │ XmCLayoutDirection     │ XmDirection   │ XmLEFT_TO_RIGHT │ CG     │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNmwmDecorations      │ XmCMwmDecorations      │ int           │ -1              │ CG     │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNmwmFunctions        │ XmCMwmFunctions        │ int           │ -1              │ CG     │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNmwmInputMode        │ XmCMwmInputMode        │ int           │ -1              │ CG     │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNmwmMenu             │ XmCMwmMenu             │ String        │ NULL            │ CG     │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNpreeditType         │ XmCPreeditType         │ String        │ dynamic         │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNshellUnitType       │ XmCShellUnitType       │ unsigned char │ XmPIXELS        │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNtextFontList        │ XmCTextFontList        │ XmFontList    │ dynamic         │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNtextRenderTable     │ XmCTextRenderTable     │ XmRenderTable │ dynamic         │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNunitType            │ XmCUnitType            │ unsigned char │ XmPIXELS        │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       │XmNuseAsyncGeometry    │ XmCUseAsyncGeometry    │ Boolean       │ False           │ CSG    │
       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
       └───────────────────────┴────────────────────────┴───────────────┴─────────────────┴────────┘
       ┌───────────────────────────────────────────────────────────────────────────────┐
       │                 │           WMShellResource 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     │ XtUnspecifiedShellInt │ CSG    │
       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
       │XmNiconY         │ XmCIconY         │ int     │ XtUnspecifiedShellInt │ 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    │
       ├────────────────────────┼─────────────────────────┼────────────────────────┼────────────────┼────────┤
       └────────────────────────┴─────────────────────────┴────────────────────────┴────────────────┴────────┘
       ┌───────────────────────────────────────────────────────────────────────┐
       │                  │     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      │ 0                    │ 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 ApplicationShell.

RELATED
       Composite(3), Core(3), Shell(3), WMShell(3), VendorShell(3), and
       TopLevelShell(3).



                                                ApplicationShell(library call)