1ApplicationShell(library call)                  ApplicationShell(library call)
2
3
4

NAME

6       ApplicationShell — The ApplicationShell widget class
7

SYNOPSIS

9       #include <Xm/Xm.h>
10       #include <X11/Shell.h>
11

DESCRIPTION

13       ApplicationShell  is  used as the main top-level window for an applica‐
14       tion. An application should have more than one ApplicationShell only if
15       it implements multiple logical applications.
16
17   Classes
18       ApplicationShell  inherits behavior and resources from Core, Composite,
19       Shell, WMShell, VendorShell, and TopLevelShell.
20
21       The class pointer is applicationShellWidgetClass.
22
23       The class name is ApplicationShell.
24
25   New Resources
26       The following table defines a set of widget resources used by the  pro‐
27       grammer  to specify data. The programmer can also set the resource val‐
28       ues for the inherited classes to set attributes  for  this  widget.  To
29       reference  a  resource by name or by class in a .Xdefaults file, remove
30       the XmN or XmC prefix and use the remaining letters. To specify one  of
31       the  defined  values for a resource in a .Xdefaults file, remove the Xm
32       prefix and use the remaining letters (in either lowercase or uppercase,
33       but  include  any  underscores between words).  The codes in the access
34       column indicate if the given resource can be set at creation time  (C),
35       set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
36       not applicable (N/A).
37
38       ┌────────────────────────────────────────────────┐
39       │        │Applicati│onShell Res│ource Set │        │
40Name    Class   Type     Default Access 
41       ├────────┼─────────┼──────────┼─────────┼────────┤
42       │XmNargc │ XmCArgc │ int      │ 0       │ CSG    │
43       ├────────┼─────────┼──────────┼─────────┼────────┤
44       │XmNargv │ XmCArgv │ String * │ NULL    │ CSG    │
45       ├────────┼─────────┼──────────┼─────────┼────────┤
46       └────────┴─────────┴──────────┴─────────┴────────┘
47       XmNargc   Specifies the  number  of  arguments  given  in  the  XmNargv
48                 resource.   The  function  XtInitialize sets this resource on
49                 the shell widget instance it creates by using its  parameters
50                 as the values.
51
52       XmNargv   Specifies  the argument list required by a session manager to
53                 restart the application if it is killed. This list should  be
54                 updated  at  appropriate  points  by the application if a new
55                 state has been reached that can be directly  restarted.   The
56                 function  XtInitialize sets this resource on the shell widget
57                 instance it creates by using its parameters  as  the  values.
58                 When  XtGetValues  is  called  on this resource, the returned
59                 value is a pointer to the actual resource  value  and  should
60                 not be freed.
61
62   Inherited Resources
63       ApplicationShell  inherits  behavior  and  resources from the following
64       superclasses. For a complete description of each resource, refer to the
65       reference page for that superclass.
66
67       ┌───────────────────────────────────────────────────────────────────────┐
68       │                    │ TopLevelShell Resour│ce Set    │         │        │
69Name                Class               Type    Default Access 
70       ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
71       │XmNiconic           │ XmCIconic           │ Boolean │ False   │ CSG    │
72       ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
73       │XmNiconName         │ XmCIconName         │ String  │ NULL    │ CSG    │
74       ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
75       │XmNiconNameEncoding │ XmCIconNameEncoding │ Atom    │ dynamic │ CSG    │
76       ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
77       └────────────────────┴─────────────────────┴─────────┴─────────┴────────┘
78       ┌───────────────────────────────────────────────────────────────────────────────────────────┐
79       │                       │         VendorShell Res│ource Set       │                 │        │
80Name                   Class                  Type          Default         Access 
81       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
82       │XmNaudibleWarning      │ XmCAudibleWarning      │ unsigned char │ XmBELL          │ CSG    │
83       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
84       │XmNbuttonFontList      │ XmCButtonFontList      │ XmFontList    │ dynamic         │ CSG    │
85       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
86       │XmNbuttonRenderTable   │ XmCButtonRenderTable   │ XmRenderTable │ dynamic         │ CSG    │
87       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
88       │XmNdefaultFontList     │ XmCDefaultFontList     │ XmFontList    │ dynamic         │ CG     │
89       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
90       │XmNdeleteResponse      │ XmCDeleteResponse      │ unsigned char │ XmDESTROY       │ CSG    │
91       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
92       │XmNinputMethod         │ XmCInputMethod         │ String        │ NULL            │ CSG    │
93       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
94       │XmNinputPolicy         │ XmCInputPolicy         │ XmInputPolicy │ XmPER_SHELL     │ CSG    │
95       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
96       │XmNkeyboardFocusPolicy │ XmCKeyboardFocusPolicy │ unsigned char │ XmEXPLICIT      │ CSG    │
97       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
98       │XmNlabelFontList       │ XmCLabelFontList       │ XmFontList    │ dynamic         │ CSG    │
99       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
100       │XmNlabelRenderTable    │ XmCLabelRenderTabel    │ XmRenderTable │ dynamic         │ CSG    │
101       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
102       │XmNlayoutDirection     │ XmCLayoutDirection     │ XmDirection   │ XmLEFT_TO_RIGHT │ CG     │
103       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
104       │XmNmwmDecorations      │ XmCMwmDecorations      │ int           │ -1              │ CG     │
105       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
106       │XmNmwmFunctions        │ XmCMwmFunctions        │ int           │ -1              │ CG     │
107       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
108       │XmNmwmInputMode        │ XmCMwmInputMode        │ int           │ -1              │ CG     │
109       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
110       │XmNmwmMenu             │ XmCMwmMenu             │ String        │ NULL            │ CG     │
111       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
112       │XmNpreeditType         │ XmCPreeditType         │ String        │ dynamic         │ CSG    │
113       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
114       │XmNshellUnitType       │ XmCShellUnitType       │ unsigned char │ XmPIXELS        │ CSG    │
115       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
116       │XmNtextFontList        │ XmCTextFontList        │ XmFontList    │ dynamic         │ CSG    │
117       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
118       │XmNtextRenderTable     │ XmCTextRenderTable     │ XmRenderTable │ dynamic         │ CSG    │
119       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
120       │XmNunitType            │ XmCUnitType            │ unsigned char │ XmPIXELS        │ CSG    │
121       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
122       │XmNuseAsyncGeometry    │ XmCUseAsyncGeometry    │ Boolean       │ False           │ CSG    │
123       ├───────────────────────┼────────────────────────┼───────────────┼─────────────────┼────────┤
124       └───────────────────────┴────────────────────────┴───────────────┴─────────────────┴────────┘
125       ┌───────────────────────────────────────────────────────────────────────────────┐
126       │                 │           WMShellResource │Set                     │        │
127Name             Class            Type    Default               Access 
128       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
129       │XmNbaseHeight    │ XmCBaseHeight    │ int     │ XtUnspecifiedShellInt │ CSG    │
130       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
131       │XmNbaseWidth     │ XmCBaseWidth     │ int     │ XtUnspecifiedShellInt │ CSG    │
132       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
133       │XmNheightInc     │ XmCHeightInc     │ int     │ XtUnspecifiedShellInt │ CSG    │
134       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
135       │XmNiconMask      │ XmCIconMask      │ Pixmap  │ NULL                  │ CSG    │
136       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
137       │XmNiconPixmap    │ XmCIconPixmap    │ Pixmap  │ NULL                  │ CSG    │
138       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
139       │XmNiconWindow    │ XmCIconWindow    │ Window  │ NULL                  │ CSG    │
140       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
141       │XmNiconX         │ XmCIconX         │ int     │ XtUnspecifiedShellInt │ CSG    │
142       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
143       │XmNiconY         │ XmCIconY         │ int     │ XtUnspecifiedShellInt │ CSG    │
144       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
145       │XmNinitialState  │ XmCInitialState  │ int     │ NormalState           │ CSG    │
146       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
147       │XmNinput         │ XmCInput         │ Boolean │ True                  │ CSG    │
148       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
149       │XmNmaxAspectX    │ XmCMaxAspectX    │ int     │ XtUnspecifiedShellInt │ CSG    │
150       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
151       │XmNmaxAspectY    │ XmCMaxAspectY    │ int     │ XtUnspecifiedShellInt │ CSG    │
152       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
153       │XmNmaxHeight     │ XmCMaxHeight     │ int     │ XtUnspecifiedShellInt │ CSG    │
154       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
155       │XmNmaxWidth      │ XmCMaxWidth      │ int     │ XtUnspecifiedShellInt │ CSG    │
156       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
157       │XmNminAspectX    │ XmCMinAspectX    │ int     │ XtUnspecifiedShellInt │ CSG    │
158       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
159       │XmNminAspectY    │ XmCMinAspectY    │ int     │ XtUnspecifiedShellInt │ CSG    │
160       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
161       │XmNminHeight     │ XmCMinHeight     │ int     │ XtUnspecifiedShellInt │ CSG    │
162       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
163       │XmNminWidth      │ XmCMinWidth      │ int     │ XtUnspecifiedShellInt │ CSG    │
164       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
165       │XmNtitle         │ XmCTitle         │ String  │ dynamic               │ CSG    │
166       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
167       │XmNtitleEncoding │ XmCTitleEncoding │ Atom    │ dynamic               │ CSG    │
168       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
169       │XmNtransient     │ XmCTransient     │ Boolean │ False                 │ CSG    │
170       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
171       │XmNwaitForWm     │ XmCWaitForWm     │ Boolean │ True                  │ CSG    │
172       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
173       │XmNwidthInc      │ XmCWidthInc      │ int     │ XtUnspecifiedShellInt │ CSG    │
174       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
175       │XmNwindowGroup   │ XmCWindowGroup   │ Window  │ dynamic               │ CSG    │
176       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
177       │XmNwinGravity    │ XmCWinGravity    │ int     │ dynamic               │ CSG    │
178       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
179       │XmNwmTimeout     │ XmCWmTimeout     │ int     │ 5000 ms               │ CSG    │
180       ├─────────────────┼──────────────────┼─────────┼───────────────────────┼────────┤
181       └─────────────────┴──────────────────┴─────────┴───────────────────────┴────────┘
182       ┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐
183       │                        │                Shell Res│ource Set                │                │        │
184Name                    Class                   Type                   Default        Access 
185       ├────────────────────────┼─────────────────────────┼────────────────────────┼────────────────┼────────┤
186       │XmNallowShellResize     │ XmCAllowShellResize     │ Boolean                │ False          │ CG     │
187       ├────────────────────────┼─────────────────────────┼────────────────────────┼────────────────┼────────┤
188       │XmNcreatePopupChildProc │ XmCCreatePopupChildProc │ XtCreatePopupChildProc │ NULL           │ CSG    │
189       ├────────────────────────┼─────────────────────────┼────────────────────────┼────────────────┼────────┤
190       │XmNgeometry             │ XmCGeometry             │ String                 │ NULL           │ CSG    │
191       ├────────────────────────┼─────────────────────────┼────────────────────────┼────────────────┼────────┤
192       │XmNoverrideRedirect     │ XmCOverrideRedirect     │ Boolean                │ False          │ CSG    │
193       ├────────────────────────┼─────────────────────────┼────────────────────────┼────────────────┼────────┤
194       │XmNpopdownCallback      │ XmCCallback             │ XtCallbackList         │ NULL           │ C      │
195       ├────────────────────────┼─────────────────────────┼────────────────────────┼────────────────┼────────┤
196       │XmNpopupCallback        │ XmCCallback             │ XtCallbackList         │ NULL           │ C      │
197       ├────────────────────────┼─────────────────────────┼────────────────────────┼────────────────┼────────┤
198       │XmNsaveUnder            │ XmCSaveUnder            │ Boolean                │ False          │ CSG    │
199       ├────────────────────────┼─────────────────────────┼────────────────────────┼────────────────┼────────┤
200       │XmNvisual               │ XmCVisual               │ Visual *               │ CopyFromParent │ CSG    │
201       ├────────────────────────┼─────────────────────────┼────────────────────────┼────────────────┼────────┤
202       └────────────────────────┴─────────────────────────┴────────────────────────┴────────────────┴────────┘
203       ┌───────────────────────────────────────────────────────────────────────┐
204       │                  │     Composite Reso│urce Set      │         │        │
205Name              Class             Type        Default Access 
206       ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
207       │XmNchildren       │ XmCReadOnly       │ WidgetList  │ NULL    │ G      │
208       ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
209       │XmNinsertPosition │ XmCInsertPosition │ XtOrderProc │ NULL    │ CSG    │
210       ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
211       │XmNnumChildren    │ XmCReadOnly       │ Cardinal    │ 0       │ G      │
212       ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
213       └──────────────────┴───────────────────┴─────────────┴─────────┴────────┘
214       ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
215       │                              │               Core Resource Se│t                │                      │        │
216Name                          Class                         Type           Default              Access 
217       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
218       │XmNaccelerators               │ XmCAccelerators               │ XtAccelerators │ dynamic              │ CSG    │
219       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
220       │XmNancestorSensitive          │ XmCSensitive                  │ Boolean        │ dynamic              │ G      │
221       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
222       │XmNbackground                 │ XmCBackground                 │ Pixel          │ dynamic              │ CSG    │
223       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
224       │XmNbackgroundPixmap           │ XmCPixmap                     │ Pixmap         │ XmUNSPECIFIED_PIXMAP │ CSG    │
225       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
226       │XmNborderColor                │ XmCBorderColor                │ Pixel          │ XtDefaultForeground  │ CSG    │
227       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
228       │XmNborderPixmap               │ XmCPixmap                     │ Pixmap         │ XmUNSPECIFIED_PIXMAP │ CSG    │
229       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
230       │XmNborderWidth                │ XmCBorderWidth                │ Dimension      │ 0                    │ CSG    │
231       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
232       │XmNcolormap                   │ XmCColormap                   │ Colormap       │ dynamic              │ CG     │
233       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
234       │XmNdepth                      │ XmCDepth                      │ int            │ dynamic              │ CG     │
235       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
236       │XmNdestroyCallback            │ XmCCallback                   │ XtCallbackList │ NULL                 │ C      │
237       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
238       │XmNheight                     │ XmCHeight                     │ Dimension      │ dynamic              │ CSG    │
239       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
240       │XmNinitialResourcesPersistent │ XmCInitialResourcesPersistent │ Boolean        │ True                 │ C      │
241       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
242       │XmNmappedWhenManaged          │ XmCMappedWhenManaged          │ Boolean        │ True                 │ CSG    │
243       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
244       │XmNscreen                     │ XmCScreen                     │ Screen *       │ dynamic              │ CG     │
245       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
246       │XmNsensitive                  │ XmCSensitive                  │ Boolean        │ True                 │ CSG    │
247       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
248       │XmNtranslations               │ XmCTranslations               │ XtTranslations │ dynamic              │ CSG    │
249       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
250       │XmNwidth                      │ XmCWidth                      │ Dimension      │ dynamic              │ CSG    │
251       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
252       │XmNx                          │ XmCPosition                   │ Position       │ 0                    │ CSG    │
253       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
254       │XmNy                          │ XmCPosition                   │ Position       │ 0                    │ CSG    │
255       ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
256       └──────────────────────────────┴───────────────────────────────┴────────────────┴──────────────────────┴────────┘
257   Translations
258       There are no translations for ApplicationShell.
259
261       Composite(3),   Core(3),   Shell(3),  WMShell(3),  VendorShell(3),  and
262       TopLevelShell(3).
263
264
265
266                                                ApplicationShell(library call)
Impressum