~ubuntu-branches/ubuntu/quantal/openmotif/quantal

« back to all changes in this revision

Viewing changes to doc/man/man3/TopLevelShell.3

  • Committer: Bazaar Package Importer
  • Author(s): Stefan Bauer
  • Date: 2010-06-23 12:12:31 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20100623121231-u89gxdp51sg9wjj2
Tags: 2.3.0-1
* New Maintainer (Closes: #379258) 
* Acknowledge NMU changes
* New upstream release (Closes: #494375)
* Get rid of security patches as they are already part of new upstream
  release (00-xpmvuln.openmotif.patch, 342092-CVE-2005-3964.patch)
* Bump Standards to 3.8.4
* Added {misc:Depends} to make the package lintian cleaner
* Fix weak-library-dev-dependency by adding ${binary:Version}) for the
  -dev Package of openmotif
* Let package depend on autotools-dev to use newer autotools-helper-files
* Work around an autoconf-bug (Gentoo-Bug #1475)
* Added Client-side anti-aliased fonts support via XFT
* Added UTF-8 and UTF8_STRING atom support
* Ability to show text and pixmaps in Label, LabelGadget and all
  derived widgets
* Support of PNG/JPEG image formats in the same way as XPM is supported
* Increase FILE_OFFSET_BITS to 64 to show files >2GB in file-selector
  Idea taken from Magne Oestlyngen (Closes: #288537)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
'\" t
 
2
...\" TopLevel.sgm /main/9 1996/09/08 21:42:33 rws $
 
3
.de P!
 
4
.fl
 
5
\!!1 setgray
 
6
.fl
 
7
\\&.\"
 
8
.fl
 
9
\!!0 setgray
 
10
.fl                     \" force out current output buffer
 
11
\!!save /psv exch def currentpoint translate 0 0 moveto
 
12
\!!/showpage{}def
 
13
.fl                     \" prolog
 
14
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
 
15
\!!psv restore
 
16
.
 
17
.de pF
 
18
.ie     \\*(f1 .ds f1 \\n(.f
 
19
.el .ie \\*(f2 .ds f2 \\n(.f
 
20
.el .ie \\*(f3 .ds f3 \\n(.f
 
21
.el .ie \\*(f4 .ds f4 \\n(.f
 
22
.el .tm ? font overflow
 
23
.ft \\$1
 
24
..
 
25
.de fP
 
26
.ie     !\\*(f4 \{\
 
27
.       ft \\*(f4
 
28
.       ds f4\"
 
29
'       br \}
 
30
.el .ie !\\*(f3 \{\
 
31
.       ft \\*(f3
 
32
.       ds f3\"
 
33
'       br \}
 
34
.el .ie !\\*(f2 \{\
 
35
.       ft \\*(f2
 
36
.       ds f2\"
 
37
'       br \}
 
38
.el .ie !\\*(f1 \{\
 
39
.       ft \\*(f1
 
40
.       ds f1\"
 
41
'       br \}
 
42
.el .tm ? font underflow
 
43
..
 
44
.ds f1\"
 
45
.ds f2\"
 
46
.ds f3\"
 
47
.ds f4\"
 
48
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
 
49
.TH "TopLevelShell" "library call"
 
50
.SH "NAME"
 
51
\fBTopLevelShell\fP \(em The TopLevelShell widget class
 
52
.iX "TopLevelShell"
 
53
.iX "widget class" "TopLevelShell"
 
54
.SH "SYNOPSIS"
 
55
.PP
 
56
.nf
 
57
#include <Xm/Xm\&.h>
 
58
#include <X11/Shell\&.h>
 
59
.fi
 
60
.SH "DESCRIPTION"
 
61
.PP
 
62
TopLevelShell is used for normal top-level windows such as any
 
63
additional top-level widgets an application needs\&.
 
64
.SS "Classes"
 
65
.PP
 
66
TopLevelShell inherits behavior and resources from \fBCore\fP,
 
67
\fBComposite\fP, \fBShell\fP,
 
68
\fBWMShell\fP, and \fBVendorShell\fP\&.
 
69
.PP
 
70
The class pointer is \fBtopLevelShellWidgetClass\fP\&.
 
71
.PP
 
72
The class name is \fBTopLevelShell\fP\&.
 
73
.SS "New Resources"
 
74
.PP
 
75
The following table defines a set of widget resources used by the programmer
 
76
to specify data\&. The programmer can also set the resource values for the
 
77
inherited classes to set attributes for this widget\&. To reference a
 
78
resource by name or by class in a \fB\&.Xdefaults\fP file, remove the \fBXmN\fP or
 
79
\fBXmC\fP prefix and use the remaining letters\&. To specify one of the defined
 
80
values for a resource in a \fB\&.Xdefaults\fP file, remove the \fBXm\fP prefix and use
 
81
the remaining letters (in either lowercase or uppercase, but include any
 
82
underscores between words)\&.
 
83
The codes in the access column indicate if the given resource can be
 
84
set at creation time (C),
 
85
set by using \fBXtSetValues\fP (S),
 
86
retrieved by using \fBXtGetValues\fP (G), or is not applicable (N/A)\&.
 
87
.PP
 
88
.TS
 
89
tab() box;
 
90
c s s s s
 
91
l| l| l| l| l.
 
92
\fBTopLevelShell Resource Set\fP
 
93
\fBName\fP\fBClass\fP\fBType\fP\fBDefault\fP\fBAccess\fP
 
94
_____
 
95
XmNiconicXmCIconicBooleanFalseCSG
 
96
_____
 
97
XmNiconNameXmCIconNameStringNULLCSG
 
98
_____
 
99
XmNiconNameEncodingXmCIconNameEncodingAtomdynamicCSG
 
100
_____
 
101
.TE
 
102
.IP "\fBXmNiconic\fP" 10
 
103
If True when the widget is \fIcreated\fP, specifies that the widget
 
104
should start as an icon when it is realized\&. A value of False
 
105
indicates that the widget is not to be realized as an icon\&. This
 
106
resource will only override the \fBXmNinitialState\fP resource when
 
107
specified in the call that creates the widget\&.
 
108
.IP "\fBXmNiconName\fP" 10
 
109
Specifies the short form of the application name to be displayed by the
 
110
window manager when the application is iconified\&.
 
111
When \fBXtGetValues\fP is called on this resource, the returned value
 
112
is a pointer to the actual resource value and
 
113
should not be freed\&.
 
114
.IP "\fBXmNiconNameEncoding\fP" 10
 
115
Specifies a property type that represents the encoding of the
 
116
\fBXmNiconName\fP string\&.
 
117
If a language procedure has been set, the default is None; otherwise,
 
118
the default is \fBXA_STRING\fP\&. When the widget is realized, if the value
 
119
is None, the corresponding name is assumed to be in the current locale\&.
 
120
The name is passed to \fBXmbTextListToTextProperty\fP with an encoding
 
121
style of \fBXStdICCTextStyle\fP\&. The resulting encoding is \fBSTRING\fP
 
122
if the name is fully convertible to \fBSTRING\fP, otherwise \fBCOMPOUND_TEXT\fP\&.
 
123
The values of the encoding resources are not changed; they remain None\&.
 
124
.SS "Inherited Resources"
 
125
.PP
 
126
TopLevelShell inherits behavior and resources from the following
 
127
superclasses\&. For a complete description of each resource, refer to the
 
128
reference page for that superclass\&.
 
129
.PP
 
130
.TS
 
131
tab() box;
 
132
c s s s s
 
133
l| l| l| l| l.
 
134
\fBVendorShell Resource Set\fP
 
135
\fBName\fP\fBClass\fP\fBType\fP\fBDefault\fP\fBAccess\fP
 
136
_____
 
137
XmNaudibleWarningXmCAudibleWarningunsigned charXmBELLCSG
 
138
_____
 
139
XmNbuttonFontListXmCButtonFontListXmFontListdynamicCSG
 
140
_____
 
141
XmNbuttonRenderTableXmCButtonRenderTableXmRenderTabledynamicCSG
 
142
_____
 
143
XmNdefaultFontListXmCDefaultFontListXmFontListdynamicCG
 
144
_____
 
145
XmNdeleteResponseXmCDeleteResponseunsigned charXmDESTROYCSG
 
146
_____
 
147
XmNinputMethodXmCInputMethodStringNULLCSG
 
148
_____
 
149
XmNinputPolicyXmCInputPolicyXmInputPolicyXmPER_SHELLCSG
 
150
_____
 
151
XmNkeyboardFocusPolicyXmCKeyboardFocusPolicyunsigned charXmEXPLICITCSG
 
152
_____
 
153
XmNlabelFontListXmCLabelFontListXmFontListdynamicCSG
 
154
_____
 
155
XmNlabelRenderTableXmCLabelRenderTabelXmRenderTabledynamicCSG
 
156
_____
 
157
XmNlayoutDirectionXmCLayoutDirectionXmDirectionXmLEFT_TO_RIGHTCG
 
158
_____
 
159
XmNmwmDecorationsXmCMwmDecorationsint-1CG
 
160
_____
 
161
XmNmwmFunctionsXmCMwmFunctionsint-1CG
 
162
_____
 
163
XmNmwmInputModeXmCMwmInputModeint-1CG
 
164
_____
 
165
XmNmwmMenuXmCMwmMenuStringNULLCG
 
166
_____
 
167
XmNpreeditTypeXmCPreeditTypeStringdynamicCSG
 
168
_____
 
169
XmNshellUnitTypeXmCShellUnitTypeunsigned charXmPIXELSCSG
 
170
_____
 
171
XmNtextFontListXmCTextFontListXmFontListdynamicCSG
 
172
_____
 
173
XmNtextRenderTableXmCTextRenderTableXmRenderTabledynamicCSG
 
174
_____
 
175
XmNunitTypeXmCUnitTypeunsigned charXmPIXELSCSG
 
176
_____
 
177
XmNuseAsyncGeometryXmCUseAsyncGeometryBooleanFalseCSG
 
178
_____
 
179
.TE
 
180
.PP
 
181
.TS
 
182
tab() box;
 
183
c s s s s
 
184
l| l| l| l| l.
 
185
\fBWMShell Resource Set\fP
 
186
\fBName\fP\fBClass\fP\fBType\fP\fBDefault\fP\fBAccess\fP
 
187
_____
 
188
XmNbaseHeightXmCBaseHeightintXtUnspecifiedShellIntCSG
 
189
_____
 
190
XmNbaseWidthXmCBaseWidthintXtUnspecifiedShellIntCSG
 
191
_____
 
192
XmNheightIncXmCHeightIncintXtUnspecifiedShellIntCSG
 
193
_____
 
194
XmNiconMaskXmCIconMaskPixmapNULLCSG
 
195
_____
 
196
XmNiconPixmapXmCIconPixmapPixmapNULLCSG
 
197
_____
 
198
XmNiconWindowXmCIconWindowWindowNULLCSG
 
199
_____
 
200
XmNiconXXmCIconXintXtUnspecifiedShellIntCSG
 
201
_____
 
202
XmNiconYXmCIconYintXtUnspecifiedShellIntCSG
 
203
_____
 
204
XmNinitialStateXmCInitialStateintNormalStateCSG
 
205
_____
 
206
XmNinputXmCInputBooleanTrueCSG
 
207
_____
 
208
XmNmaxAspectXXmCMaxAspectXintXtUnspecifiedShellIntCSG
 
209
_____
 
210
XmNmaxAspectYXmCMaxAspectYintXtUnspecifiedShellIntCSG
 
211
_____
 
212
XmNmaxHeightXmCMaxHeightintXtUnspecifiedShellIntCSG
 
213
_____
 
214
XmNmaxWidthXmCMaxWidthintXtUnspecifiedShellIntCSG
 
215
_____
 
216
XmNminAspectXXmCMinAspectXintXtUnspecifiedShellIntCSG
 
217
_____
 
218
XmNminAspectYXmCMinAspectYintXtUnspecifiedShellIntCSG
 
219
_____
 
220
XmNminHeightXmCMinHeightintXtUnspecifiedShellIntCSG
 
221
_____
 
222
XmNminWidthXmCMinWidthintXtUnspecifiedShellIntCSG
 
223
_____
 
224
XmNtitleXmCTitleStringdynamicCSG
 
225
_____
 
226
XmNtitleEncodingXmCTitleEncodingAtomdynamicCSG
 
227
_____
 
228
XmNtransientXmCTransientBooleanFalseCSG
 
229
_____
 
230
XmNwaitForWmXmCWaitForWmBooleanTrueCSG
 
231
_____
 
232
XmNwidthIncXmCWidthIncintXtUnspecifiedShellIntCSG
 
233
_____
 
234
XmNwindowGroupXmCWindowGroupWindowdynamicCSG
 
235
_____
 
236
XmNwinGravityXmCWinGravityintdynamicCSG
 
237
_____
 
238
XmNwmTimeoutXmCWmTimeoutint5000 msCSG
 
239
_____
 
240
.TE
 
241
.PP
 
242
.TS
 
243
tab() box;
 
244
c s s s s
 
245
l| l| l| l| l.
 
246
\fBShell Resource Set\fP
 
247
\fBName\fP\fBClass\fP\fBType\fP\fBDefault\fP\fBAccess\fP
 
248
_____
 
249
XmNallowShellResizeXmCAllowShellResizeBooleanFalseCG
 
250
_____
 
251
XmNcreatePopupChildProcXmCCreatePopupChildProcXtCreatePopupChildProcNULLCSG
 
252
_____
 
253
XmNgeometryXmCGeometryStringNULLCSG
 
254
_____
 
255
XmNoverrideRedirectXmCOverrideRedirectBooleanFalseCSG
 
256
_____
 
257
XmNpopdownCallbackXmCCallbackXtCallbackListNULLC
 
258
_____
 
259
XmNpopupCallbackXmCCallbackXtCallbackListNULLC
 
260
_____
 
261
XmNsaveUnderXmCSaveUnderBooleanFalseCSG
 
262
_____
 
263
XmNvisualXmCVisualVisual *CopyFromParentCSG
 
264
_____
 
265
.TE
 
266
.PP
 
267
.TS
 
268
tab() box;
 
269
c s s s s
 
270
l| l| l| l| l.
 
271
\fBComposite Resource Set\fP
 
272
\fBName\fP\fBClass\fP\fBType\fP\fBDefault\fP\fBAccess\fP
 
273
_____
 
274
XmNchildrenXmCReadOnlyWidgetListNULLG
 
275
_____
 
276
XmNinsertPositionXmCInsertPositionXtOrderProcNULLCSG
 
277
_____
 
278
XmNnumChildrenXmCReadOnlyCardinal0G
 
279
_____
 
280
.TE
 
281
.PP
 
282
.TS
 
283
tab() box;
 
284
c s s s s
 
285
l| l| l| l| l.
 
286
\fBCore Resource Set\fP
 
287
\fBName\fP\fBClass\fP\fBType\fP\fBDefault\fP\fBAccess\fP
 
288
_____
 
289
XmNacceleratorsXmCAcceleratorsXtAcceleratorsdynamicCSG
 
290
_____
 
291
XmNancestorSensitiveXmCSensitiveBooleandynamicG
 
292
_____
 
293
XmNbackgroundXmCBackgroundPixeldynamicCSG
 
294
_____
 
295
XmNbackgroundPixmapXmCPixmapPixmapXmUNSPECIFIED_PIXMAPCSG
 
296
_____
 
297
XmNborderColorXmCBorderColorPixelXtDefaultForegroundCSG
 
298
_____
 
299
XmNborderPixmapXmCPixmapPixmapXmUNSPECIFIED_PIXMAPCSG
 
300
_____
 
301
XmNborderWidthXmCBorderWidthDimension0CSG
 
302
_____
 
303
XmNcolormapXmCColormapColormapdynamicCG
 
304
_____
 
305
XmNdepthXmCDepthintdynamicCG
 
306
_____
 
307
XmNdestroyCallbackXmCCallbackXtCallbackListNULLC
 
308
_____
 
309
XmNheightXmCHeightDimensiondynamicCSG
 
310
_____
 
311
XmNinitialResourcesPersistentXmCInitialResourcesPersistentBooleanTrueC
 
312
_____
 
313
XmNmappedWhenManagedXmCMappedWhenManagedBooleanTrueCSG
 
314
_____
 
315
XmNscreenXmCScreenScreen *dynamicCG
 
316
_____
 
317
XmNsensitiveXmCSensitiveBooleanTrueCSG
 
318
_____
 
319
XmNtranslationsXmCTranslationsXtTranslationsdynamicCSG
 
320
_____
 
321
XmNwidthXmCWidthDimensiondynamicCSG
 
322
_____
 
323
XmNxXmCPositionPosition0CSG
 
324
_____
 
325
XmNyXmCPositionPosition0CSG
 
326
_____
 
327
.TE
 
328
.SS "Translations"
 
329
.PP
 
330
There are no translations for TopLevelShell\&.
 
331
.SH "RELATED"
 
332
.PP
 
333
\fBComposite\fP(3), \fBCore\fP(3), \fBShell\fP(3), \fBWMShell\fP(3), and
 
334
\fBVendorShell\fP(3)\&.
 
335
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:16