← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/vnc4/gutsy

« back to all changes in this revision

Viewing changes to unix/xc/doc/man/Xt/XtRealize.man

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
unix/xc/doc/man/Xt/XtRealize.man
 
1
.\" $Xorg: XtRealize.man,v 1.3 2000/08/17 19:42:02 cpqbld Exp $
 
2
.\"
 
3
.\" Copyright 1993 X Consortium
 
4
.\"
 
5
.\" Permission is hereby granted, free of charge, to any person obtaining
 
6
.\" a copy of this software and associated documentation files (the
 
7
.\" "Software"), to deal in the Software without restriction, including
 
8
.\" without limitation the rights to use, copy, modify, merge, publish,
 
9
.\" distribute, sublicense, and/or sell copies of the Software, and to
 
10
.\" permit persons to whom the Software is furnished to do so, subject to
 
11
.\" the following conditions:
 
12
.\"
 
13
.\" The above copyright notice and this permission notice shall be
 
14
.\" included in all copies or substantial portions of the Software.
 
15
.\"
 
16
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 
17
.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 
18
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 
19
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
 
20
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 
21
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 
22
.\" OTHER DEALINGS IN THE SOFTWARE.
 
23
.\"
 
24
.\" Except as contained in this notice, the name of the X Consortium shall
 
25
.\" not be used in advertising or otherwise to promote the sale, use or
 
26
.\" other dealings in this Software without prior written authorization
 
27
.\" from the X Consortium.
 
28
.\"
 
29
.\" $XFree86: xc/doc/man/Xt/XtRealize.man,v 1.2 2001/01/27 18:20:29 dawes Exp $
 
30
.\"
 
31
.ds tk X Toolkit
 
32
.ds xT X Toolkit Intrinsics \- C Language Interface
 
33
.ds xI Intrinsics
 
34
.ds xW X Toolkit Athena Widgets \- C Language Interface
 
35
.ds xL Xlib \- C Language X Interface
 
36
.ds xC Inter-Client Communication Conventions Manual
 
37
.ds Rn 3
 
38
.ds Vn 2.2
 
39
.hw XtRealize-Widget XtIs-Realized XtUnrealize-Widget wid-get
 
40
.na
 
41
.de Ds
 
42
.nf
 
43
.\\$1D \\$2 \\$1
 
44
.ft 1
 
45
.ps \\n(PS
 
46
.\".if \\n(VS>=40 .vs \\n(VSu
 
47
.\".if \\n(VS<=39 .vs \\n(VSp
 
48
..
 
49
.de De
 
50
.ce 0
 
51
.if \\n(BD .DF
 
52
.nr BD 0
 
53
.in \\n(OIu
 
54
.if \\n(TM .ls 2
 
55
.sp \\n(DDu
 
56
.fi
 
57
..
 
58
.de FD
 
59
.LP
 
60
.KS
 
61
.TA .5i 3i
 
62
.ta .5i 3i
 
63
.nf
 
64
..
 
65
.de FN
 
66
.fi
 
67
.KE
 
68
.LP
 
69
..
 
70
.de IN          \" send an index entry to the stderr
 
71
..
 
72
.de C{
 
73
.KS
 
74
.nf
 
75
.D
 
76
.\"
 
77
.\"     choose appropriate monospace font
 
78
.\"     the imagen conditional, 480,
 
79
.\"     may be changed to L if LB is too
 
80
.\"     heavy for your eyes...
 
81
.\"
 
82
.ie "\\*(.T"480" .ft L
 
83
.el .ie "\\*(.T"300" .ft L
 
84
.el .ie "\\*(.T"202" .ft PO
 
85
.el .ie "\\*(.T"aps" .ft CW
 
86
.el .ft R
 
87
.ps \\n(PS
 
88
.ie \\n(VS>40 .vs \\n(VSu
 
89
.el .vs \\n(VSp
 
90
..
 
91
.de C}
 
92
.DE
 
93
.R
 
94
..
 
95
.de Pn
 
96
.ie t \\$1\fB\^\\$2\^\fR\\$3
 
97
.el \\$1\fI\^\\$2\^\fP\\$3
 
98
..
 
99
.de ZN
 
100
.ie t \fB\^\\$1\^\fR\\$2
 
101
.el \fI\^\\$1\^\fP\\$2
 
102
..
 
103
.de NT
 
104
.ne 7
 
105
.ds NO Note
 
106
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
 
107
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
 
108
.ie n .sp
 
109
.el .sp 10p
 
110
.TB
 
111
.ce
 
112
\\*(NO
 
113
.ie n .sp
 
114
.el .sp 5p
 
115
.if '\\$1'C' .ce 99
 
116
.if '\\$2'C' .ce 99
 
117
.in +5n
 
118
.ll -5n
 
119
.R
 
120
..
 
121
.               \" Note End -- doug kraft 3/85
 
122
.de NE
 
123
.ce 0
 
124
.in -5n
 
125
.ll +5n
 
126
.ie n .sp
 
127
.el .sp 10p
 
128
..
 
129
.ny0
 
130
.TH XtRealizeWidget 3Xt __xorgversion__ "XT FUNCTIONS"
 
131
.SH NAME
 
132
XtRealizeWidget, XtIsRealized, XtUnrealizeWidget \- realize and unrealize widgets
 
133
.SH SYNTAX
 
134
void XtRealizeWidget(\fIw\fP)
 
135
.br
 
136
      Widget \fIw\fP;
 
137
.LP
 
138
Boolean XtIsRealized(\fIw\fP)
 
139
.br
 
140
      Widget \fIw\fP;
 
141
.LP
 
142
void XtUnrealizeWidget(\fIw\fP)
 
143
.br
 
144
      Widget \fIw\fP;
 
145
.SH ARGUMENTS
 
146
.IP \fIw\fP 1i
 
147
Specifies the widget.
 
148
.SH DESCRIPTION
 
149
If the widget is already realized,
 
150
.ZN XtRealizeWidget
 
151
simply returns. 
 
152
Otherwise, it performs the following:
 
153
.IP \(bu 5
 
154
Binds all action names in the widget's
 
155
translation table to procedures (see Section 10.1.2).
 
156
.IP \(bu 5
 
157
Makes a post-order traversal of the widget tree rooted
 
158
at the specified widget and calls the change_managed procedure
 
159
of each composite widget that has one or more managed children.
 
160
.IP \(bu 5
 
161
Constructs an
 
162
.ZN XSetWindowAttributes
 
163
structure filled in with information derived from the 
 
164
.ZN Core 
 
165
widget fields and calls the realize procedure for the widget,
 
166
which adds any widget-specific attributes and creates the X window.
 
167
.IP \(bu 5
 
168
If the widget is
 
169
not a subclass of 
 
170
.ZN compositeWidgetClass ,
 
171
.ZN XtRealizeWidget
 
172
returns; otherwise, it continues and performs the following:
 
173
.RS
 
174
.IP \- 5
 
175
Descends recursively to each of the widget's
 
176
managed children and calls the realize procedures.
 
177
Primitive widgets that instantiate children are responsible for realizing
 
178
those children themselves.
 
179
.IP \- 5
 
180
Maps all of the managed children windows that have mapped_when_managed 
 
181
.ZN True .
 
182
(If a widget is managed but mapped_when_managed is 
 
183
.ZN False , 
 
184
the widget is allocated visual space but is not displayed.
 
185
Some people seem to like this to indicate certain states.)
 
186
.RE
 
187
.LP
 
188
If the widget is a top-level shell widget (that is, it has no parent), and
 
189
mapped_when_managed is 
 
190
.ZN True , 
 
191
.ZN XtRealizeWidget
 
192
maps the widget window.
 
193
.LP
 
194
The
 
195
.ZN XtIsRealized
 
196
function returns 
 
197
.ZN True 
 
198
if the widget has been realized,
 
199
that is, if the widget has a nonzero X window ID.
 
200
.LP
 
201
Some widget procedures (for example, set_values) might wish to
 
202
operate differently
 
203
after the widget has been realized.
 
204
.LP
 
205
The
 
206
.ZN XtUnrealizeWidget
 
207
function destroys the windows of an existing widget and all of its
 
208
children (recursively down the widget tree).
 
209
To recreate the windows at a later time,
 
210
call
 
211
.ZN XtRealizeWidget
 
212
again.
 
213
If the widget was managed, 
 
214
it will be unmanaged automatically before its window is freed.
 
215
.SH "SEE ALSO"
 
216
XtManageChildren(3Xt)
 
217
.br
 
218
\fI\*(xT\fP
 
219
.br
 
220
\fI\*(xL\fP