← 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/XtNameTWid.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/XtNameTWid.man
 
1
.\" $Xorg: XtNameTWid.man,v 1.3 2000/08/17 19:42:01 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/XtNameTWid.man,v 1.2 2001/01/27 18:20:28 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 XtName-To-Widget XtWindow-To-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 XtNameToWidget 3Xt __xorgversion__ "XT FUNCTIONS"
 
131
.SH NAME
 
132
XtNameToWidget, XtWindowToWidget \- translating strings to widgets or widgets to windows
 
133
.SH SYNTAX
 
134
Widget XtNameToWidget(\fIreference\fP, \fInames\fP);
 
135
.br
 
136
      Widget \fIreference\fP;
 
137
.br
 
138
      String \fInames\fP;
 
139
.LP
 
140
Widget XtWindowToWidget(\fIdisplay\fP, \fIwindow\fP)
 
141
.br
 
142
      Display *\fIdisplay\fP;
 
143
.br
 
144
      Window \fIwindow\fP;
 
145
.SH ARGUMENTS
 
146
.ds Di \ on which the window is defined
 
147
.IP \fIdisplay\fP 1i
 
148
Specifies the display\*(Di.
 
149
.IP \fInames\fP 1i
 
150
Specifies the fully qualified name of the desired widget.
 
151
.IP \fIreference\fP 1i
 
152
Specifies the widget from which the search is to start.
 
153
.IP \fIwindow\fP 1i
 
154
Specify the window for which you want the widget.
 
155
.SH DESCRIPTION
 
156
The
 
157
.ZN XtNameToWidget
 
158
function looks for a widget whose name is the first component in the specified
 
159
names and that is a pop-up child of reference (or a normal child if reference
 
160
is a subclass of
 
161
.ZN compositeWidgetClass ).
 
162
It then uses that widget as the new reference and repeats the search
 
163
after deleting the first component from the specified names.
 
164
If it cannot find the specified widget,
 
165
.ZN XtNameToWidget
 
166
returns NULL.
 
167
.LP
 
168
Note that the names argument contains the name of a widget with respect to the 
 
169
specified reference widget and can contain more than one widget name
 
170
(separated by periods) for widgets that are not direct children 
 
171
of the specified reference widget.
 
172
.LP
 
173
If more than one child of the reference widget matches the name,
 
174
.ZN XtNameToWidget
 
175
can return any of the children.
 
176
The \*(xI do not require that all children of a widget have unique names.
 
177
If the specified names contain more than one component
 
178
and if more than one child matches the first component,
 
179
.ZN XtNameToWidget
 
180
can return NULL if the single branch that it follows does not
 
181
contain the named widget.
 
182
That is,
 
183
.ZN XtNameToWidget
 
184
does not back up and follow other matching branches of the widget tree.
 
185
.LP
 
186
The
 
187
.ZN XtWindowToWidget
 
188
function translates the specified window and display pointer into the
 
189
appropriate widget instance.
 
190
.SH "SEE ALSO"
 
191
.br
 
192
\fI\*(xT\fP
 
193
.br
 
194
\fI\*(xL\fP