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

NAME

6       TopLevelShell — The TopLevelShell widget class
7

SYNOPSIS

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

DESCRIPTION

13       TopLevelShell  is  used  for normal top-level windows such as any addi‐
14       tional top-level widgets an application needs.
15
16   Classes
17       TopLevelShell inherits behavior and  resources  from  Core,  Composite,
18       Shell, WMShell, and VendorShell.
19
20       The class pointer is topLevelShellWidgetClass.
21
22       The class name is TopLevelShell.
23
24   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
37       ┌───────────────────────────────────────────────────────────────────────┐
38       │                    │ TopLevelShell Resour│ce Set    │         │        │
39Name                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
54       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
61       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
73   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
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 TopLevelShell.
259
261       Composite(3), Core(3), Shell(3), WMShell(3), and VendorShell(3).
262
263
264
265                                                   TopLevelShell(library call)
Impressum