1TopLevelShell(library call) TopLevelShell(library call)
2
6 TopLevelShell — The TopLevelShell widget class
7
9 #include <Xm/Xm.h>
10 #include <X11/Shell.h>
11
13 TopLevelShell is used for normal top-level windows such as any addi‐
14 tional top-level widgets an application needs.
15 Classes
17 TopLevelShell inherits behavior and resources from Core, Composite,
18 Shell, WMShell, and VendorShell.
19 The class pointer is topLevelShellWidgetClass.
21 The class name is TopLevelShell.
23 New Resources
25 The following table defines a set of widget resources used by the pro‐
26 grammer to specify data. The programmer can also set the resource val‐
27 ues for the inherited classes to set attributes for this widget. To
28 reference a resource by name or by class in a .Xdefaults file, remove
29 the XmN or XmC prefix and use the remaining letters. To specify one of
30 the defined values for a resource in a .Xdefaults file, remove the Xm
31 prefix and use the remaining letters (in either lowercase or uppercase,
32 but include any underscores between words). The codes in the access
33 column indicate if the given resource can be set at creation time (C),
34 set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
35 not applicable (N/A).
36 ┌───────────────────────────────────────────────────────────────────────┐
38 │ │ TopLevelShell Resour│ce Set │ │ │
39 │Name │ Class │ Type │ Default │ Access │
40 ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
41 │XmNiconic │ XmCIconic │ Boolean │ False │ CSG │
42 ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
43 │XmNiconName │ XmCIconName │ String │ NULL │ CSG │
44 ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
45 │XmNiconNameEncoding │ XmCIconNameEncoding │ Atom │ dynamic │ CSG │
46 ├────────────────────┼─────────────────────┼─────────┼─────────┼────────┤
47 └────────────────────┴─────────────────────┴─────────┴─────────┴────────┘
48 XmNiconic If True when the widget is created, specifies that the widget
49 should start as an icon when it is realized. A value of False
50 indicates that the widget is not to be realized as an icon.
51 This resource will only override the XmNinitialState resource
52 when specified in the call that creates the widget.
53 XmNiconName
55 Specifies the short form of the application name to be dis‐
56 played by the window manager when the application is iconi‐
57 fied. When XtGetValues is called on this resource, the
58 returned value is a pointer to the actual resource value and
59 should not be freed.
60 XmNiconNameEncoding
62 Specifies a property type that represents the encoding of the
63 XmNiconName string. If a language procedure has been set,
64 the default is None; otherwise, the default is XA_STRING.
65 When the widget is realized, if the value is None, the corre‐
66 sponding name is assumed to be in the current locale. The
67 name is passed to XmbTextListToTextProperty with an encoding
68 style of XStdICCTextStyle. The resulting encoding is STRING
69 if the name is fully convertible to STRING, otherwise COM‐
70 POUND_TEXT. The values of the encoding resources are not
71 changed; they remain None.
72 Inherited Resources
74 TopLevelShell inherits behavior and resources from the following super‐
75 classes. For a complete description of each resource, refer to the ref‐
76 erence page for that superclass.
77 ┌───────────────────────────────────────────────────────────────────────────────────────────┐
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 TopLevelShell.
259
261 Composite(3), Core(3), Shell(3), WMShell(3), and VendorShell(3).
262 TopLevelShell(library call)