1ApplicationShell(library call) ApplicationShell(library call)
2
6 ApplicationShell — The ApplicationShell widget class
7
9 #include <Xm/Xm.h>
10 #include <X11/Shell.h>
11
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 Classes
18 ApplicationShell inherits behavior and resources from Core, Composite,
19 Shell, WMShell, VendorShell, and TopLevelShell.
20 The class pointer is applicationShellWidgetClass.
22 The class name is ApplicationShell.
24 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 ┌────────────────────────────────────────────────┐
39 │ │Applicati│onShell Res│ource Set │ │
40 │Name │ 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 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 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 ┌───────────────────────────────────────────────────────────────────────┐
68 │ │ TopLevelShell Resour│ce Set │ │ │
69 │Name │ 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 │ │ │
80 │Name │ 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 │ │ WMShell│Resource │Set │ │
127 │Name │ 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 │ │ │
184 │Name │ 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 │ │ │
205 │Name │ 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 │ │ │
216 │Name │ 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 ApplicationShell(library call)