Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
XReparentWindow(3)		XLIB FUNCTIONS		    XReparentWindow(3)

NAME
       XReparentWindow - reparent windows

SYNTAX

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

ARGUMENTS
       display	 Specifies the connection to the X server.

       parent	 Specifies the parent window.

       w	 Specifies the window.

       x
       y	 Specify the x and y coordinates of the	position  in  the  new
		 parent	window.

DESCRIPTION
       If  the	specified window is mapped, XReparentWindow automatically per-
       forms an	UnmapWindow request on it, removes it from its	current	 posi-
       tion  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 mem-
       ber returned in this event is set to  the  window's  corresponding  at-
       tribute.	  Window  manager clients usually should ignore	this window if
       this member is set to True.  Finally, if	the specified window was orig-
       inally 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.  A BadMatch	error results if:

       •    The	new parent window is not on the	same screen as the old	parent
	    window.

       •    The	 new  parent  window is	the specified window or	an inferior of
	    the	specified window.

       •    The	new parent is InputOnly, and the window	is not.

       •    The	specified window has a ParentRelative background, and the  new
	    parent window is not the same depth	as the specified window.

       XReparentWindow can generate BadMatch and BadWindow errors.

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

SEE ALSO
       XChangeSaveSet(3)
       Xlib - C	Language X Interface

X Version 11			 libX11	1.8.12		    XReparentWindow(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XReparentWindow&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help