upload tizen2.0 source
[framework/uifw/xorg/lib/libx11.git] / man / XReparentEvent.man
1 .\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium
2 .\"
3 .\" Permission is hereby granted, free of charge, to any person obtaining
4 .\" a copy of this software and associated documentation files (the
5 .\" "Software"), to deal in the Software without restriction, including
6 .\" without limitation the rights to use, copy, modify, merge, publish,
7 .\" distribute, sublicense, and/or sell copies of the Software, and to
8 .\" permit persons to whom the Software is furnished to do so, subject to
9 .\" the following conditions:
10 .\"
11 .\" The above copyright notice and this permission notice shall be included
12 .\" in all copies or substantial portions of the Software.
13 .\"
14 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 .\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 .\" OTHER DEALINGS IN THE SOFTWARE.
21 .\"
22 .\" Except as contained in this notice, the name of the X Consortium shall
23 .\" not be used in advertising or otherwise to promote the sale, use or
24 .\" other dealings in this Software without prior written authorization
25 .\" from the X Consortium.
26 .\"
27 .\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991 by
28 .\" Digital Equipment Corporation
29 .\"
30 .\" Portions Copyright \(co 1990, 1991 by
31 .\" Tektronix, Inc.
32 .\"
33 .\" Permission to use, copy, modify and distribute this documentation for
34 .\" any purpose and without fee is hereby granted, provided that the above
35 .\" copyright notice appears in all copies and that both that copyright notice
36 .\" and this permission notice appear in all copies, and that the names of
37 .\" Digital and Tektronix not be used in in advertising or publicity pertaining
38 .\" to this documentation without specific, written prior permission.
39 .\" Digital and Tektronix makes no representations about the suitability
40 .\" of this documentation for any purpose.
41 .\" It is provided ``as is'' without express or implied warranty.
42 .\" 
43 .\"
44 .ds xT X Toolkit Intrinsics \- C Language Interface
45 .ds xW Athena X Widgets \- C Language X Toolkit Interface
46 .ds xL Xlib \- C Language X Interface
47 .ds xC Inter-Client Communication Conventions Manual
48 .na
49 .de Ds
50 .nf
51 .\\$1D \\$2 \\$1
52 .ft 1
53 .\".ps \\n(PS
54 .\".if \\n(VS>=40 .vs \\n(VSu
55 .\".if \\n(VS<=39 .vs \\n(VSp
56 ..
57 .de De
58 .ce 0
59 .if \\n(BD .DF
60 .nr BD 0
61 .in \\n(OIu
62 .if \\n(TM .ls 2
63 .sp \\n(DDu
64 .fi
65 ..
66 .de FD
67 .LP
68 .KS
69 .TA .5i 3i
70 .ta .5i 3i
71 .nf
72 ..
73 .de FN
74 .fi
75 .KE
76 .LP
77 ..
78 .de IN          \" send an index entry to the stderr
79 ..
80 .de C{
81 .KS
82 .nf
83 .D
84 .\"
85 .\"     choose appropriate monospace font
86 .\"     the imagen conditional, 480,
87 .\"     may be changed to L if LB is too
88 .\"     heavy for your eyes...
89 .\"
90 .ie "\\*(.T"480" .ft L
91 .el .ie "\\*(.T"300" .ft L
92 .el .ie "\\*(.T"202" .ft PO
93 .el .ie "\\*(.T"aps" .ft CW
94 .el .ft R
95 .ps \\n(PS
96 .ie \\n(VS>40 .vs \\n(VSu
97 .el .vs \\n(VSp
98 ..
99 .de C}
100 .DE
101 .R
102 ..
103 .de Pn
104 .ie t \\$1\fB\^\\$2\^\fR\\$3
105 .el \\$1\fI\^\\$2\^\fP\\$3
106 ..
107 .de ZN
108 .ie t \fB\^\\$1\^\fR\\$2
109 .el \fI\^\\$1\^\fP\\$2
110 ..
111 .de hN
112 .ie t <\fB\\$1\fR>\\$2
113 .el <\fI\\$1\fP>\\$2
114 ..
115 .de NT
116 .ne 7
117 .ds NO Note
118 .if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
119 .if \\n(.$ .if !'\\$1'C' .ds NO \\$1
120 .ie n .sp
121 .el .sp 10p
122 .TB
123 .ce
124 \\*(NO
125 .ie n .sp
126 .el .sp 5p
127 .if '\\$1'C' .ce 99
128 .if '\\$2'C' .ce 99
129 .in +5n
130 .ll -5n
131 .R
132 ..
133 .               \" Note End -- doug kraft 3/85
134 .de NE
135 .ce 0
136 .in -5n
137 .ll +5n
138 .ie n .sp
139 .el .sp 10p
140 ..
141 .ny0
142 .TH XReparentEvent __libmansuffix__ __xorgversion__ "XLIB FUNCTIONS"
143 .SH NAME
144 XReparentEvent \- ReparentNotify event structure
145 .SH STRUCTURES
146 The structure for
147 .ZN ReparentNotify
148 events contains:
149 .LP
150 .Ds 0
151 .TA .5i 3i
152 .ta .5i 3i
153 typedef struct {
154         int type;       /\&* ReparentNotify */
155         unsigned long serial;   /\&* # of last request processed by server */
156         Bool send_event;        /\&* true if this came from a SendEvent request */
157         Display *display;       /\&* Display the event was read from */
158         Window event;
159         Window window;
160         Window parent;
161         int x, y;
162         Bool override_redirect;
163 } XReparentEvent;
164 .De
165 .LP
166 When you receive this event,
167 the structure members are set as follows.
168 .LP
169 The type member is set to the event type constant name that uniquely identifies
170 it.
171 For example, when the X server reports a
172 .ZN GraphicsExpose
173 event to a client application, it sends an
174 .ZN XGraphicsExposeEvent
175 structure with the type member set to
176 .ZN GraphicsExpose .
177 The display member is set to a pointer to the display the event was read on.
178 The send_event member is set to
179 .ZN True
180 if the event came from a
181 .ZN SendEvent
182 protocol request.
183 The serial member is set from the serial number reported in the protocol
184 but expanded from the 16-bit least-significant bits to a full 32-bit value.
185 The window member is set to the window that is most useful to toolkit
186 dispatchers.
187 .LP
188 The event member is set either to the reparented window
189 or to the old or the new parent, depending on whether
190 .ZN StructureNotify
191 or
192 .ZN SubstructureNotify
193 was selected. 
194 The window member is set to the window that was reparented.
195 The parent member is set to the new parent window.
196 The x and y members are set to the reparented window's coordinates relative 
197 to the new parent window's
198 origin and define the upper-left outer corner of the reparented window.
199 The override_redirect member is set to the override-redirect attribute of the
200 window specified by the window member.
201 Window manager clients normally should ignore this window 
202 if the override_redirect member is
203 .ZN True .
204 .SH "SEE ALSO"
205 XAnyEvent(__libmansuffix__),
206 XButtonEvent(__libmansuffix__),
207 XCreateWindowEvent(__libmansuffix__),
208 XCirculateEvent(__libmansuffix__),
209 XCirculateRequestEvent(__libmansuffix__),
210 XColormapEvent(__libmansuffix__),
211 XConfigureEvent(__libmansuffix__),
212 XConfigureRequestEvent(__libmansuffix__),
213 XCrossingEvent(__libmansuffix__),
214 XDestroyWindowEvent(__libmansuffix__),
215 XErrorEvent(__libmansuffix__),
216 XExposeEvent(__libmansuffix__),
217 XFocusChangeEvent(__libmansuffix__),
218 XGraphicsExposeEvent(__libmansuffix__),
219 XGravityEvent(__libmansuffix__),
220 XKeymapEvent(__libmansuffix__),
221 XMapEvent(__libmansuffix__),
222 XMapRequestEvent(__libmansuffix__),
223 XPropertyEvent(__libmansuffix__),
224 XResizeRequestEvent(__libmansuffix__),
225 XSelectionClearEvent(__libmansuffix__),
226 XSelectionEvent(__libmansuffix__),
227 XSelectionRequestEvent(__libmansuffix__),
228 XUnmapEvent(__libmansuffix__),
229 XVisibilityEvent(__libmansuffix__)
230 .br
231 \fI\*(xL\fP