XReparentWindow(3X)                           XReparentWindow(3X)



NAME
     XReparentWindow - reparents windows

SYNOPSIS
     XReparentWindow (display, w, parent, x, y)
     Display *display;
     Window w;
     Window parent;
     int x,y;

DESCRIPTION
     The XReparentWindow function reparents the specified window
     by inserting it as the child of the specified parent.  If
     the specified window is mapped, XReparentWindow automatical-
     ly performs an UnmapWindow request on it, removes it from
     its current position in the hierarchy, and inserts it as the
     child of the specified parent.  The window is placed in the
     stacking order on top with respect to sibling windows.

     After reparenting the specified window, XReparentWindow
     causes the X server to generate a ReparentNotify event.  The
     override_redirect member returned in this event is set to
     the window's corresponding attribute.  Window manager
     clients usually should ignore this window if this member is
     set to TRUE.  Finally, if the specified window was original-
     ly mapped, the X server automatically performs a MapWindow
     request on it.

     The X server performs normal exposure processing on formerly
     obscured windows.  The X server might not generate Expose
     events for regions from the initial UnmapWindow request that
     are immediately obscured by the final MapWindow request.

   Arguments
     This function accepts the following arguments:

     display Specifies the connection to the X server.

     parent  Specifies the parent window ID.

     w       Specifies the window ID.

     x, y    Specify the x and y coordinates of the position of
             the specified window within the new parent window.

ERRORS
     BadMatch
             The new parent window is not the same as the old
             parent window; the new parent window is the speci-
             fied window or an inferior window of the specified
             window; or the specified window has a ParentRelative
             background and the new parent window is not the same



November, 1990                                                  1

XReparentWindow(3X)                           XReparentWindow(3X)



             depth as the specified window.

     BadWindow
             A value for a Window argument does not name a de-
             fined window.

SEE ALSO
     XChangeSaveSet(3X)

     Xlib - C Language Interface














































2                                                  November, 1990