1XReparentWindow(3)              XLIB FUNCTIONS              XReparentWindow(3)
2
3
4

NAME

6       XReparentWindow - reparent windows
7

SYNTAX

9       int  XReparentWindow(Display  *display, Window w, Window parent, int x,
10              int y);
11

ARGUMENTS

13       display   Specifies the connection to the X server.
14
15       parent    Specifies the parent window.
16
17       w         Specifies the window.
18
19       x
20       y         Specify the x and y coordinates of the position  in  the  new
21                 parent window.
22

DESCRIPTION

24       If  the  specified window is mapped, XReparentWindow automatically per‐
25       forms an UnmapWindow request on it, removes it from its  current  posi‐
26       tion  in  the  hierarchy,  and inserts it as the child of the specified
27       parent.  The window is placed in the stacking order on top with respect
28       to sibling windows.
29
30       After  reparenting  the  specified window, XReparentWindow causes the X
31       server to generate a ReparentNotify event.  The override_redirect  mem‐
32       ber  returned in this event is set to the window's corresponding attri‐
33       bute.  Window manager clients usually should ignore this window if this
34       member is set to True.  Finally, if the specified window was originally
35       mapped, the X server automatically performs a MapWindow request on it.
36
37       The X server performs normal exposure processing on  formerly  obscured
38       windows.   The  X  server  might not generate Expose events for regions
39       from the initial UnmapWindow request that are immediately  obscured  by
40       the final MapWindow request.  A BadMatch error results if:
41
42       •    The  new parent window is not on the same screen as the old parent
43            window.
44
45       •    The new parent window is the specified window or  an  inferior  of
46            the specified window.
47
48       •    The new parent is InputOnly, and the window is not.
49
50       •    The  specified window has a ParentRelative background, and the new
51            parent window is not the same depth as the specified window.
52
53       XReparentWindow can generate BadMatch and BadWindow errors.
54

DIAGNOSTICS

56       BadWindow A value for a Window argument does not name a defined Window.
57

SEE ALSO

59       XChangeSaveSet(3)
60       Xlib - C Language X Interface
61
62
63
64X Version 11                     libX11 1.8.1               XReparentWindow(3)
Impressum