NAME

XResizeWindow − change a window’s size. 

Synopsis

XResizeWindow(display, w, width, height)
Display *display;
Window w;
unsigned int width, height;

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

wSpecifies the ID of the window to be resized. 

width

heightSpecify the new dimensions of the window in pixels. 

Description

XResizeWindow() changes the inside dimensions of the window.  The border is resized to match but its border width is not changed.  XResizeWindow() does not raise the window, or change its origin.  Changing the size of a mapped window may lose its contents and generate an Expose event, depending on the bit_gravity attribute (see Volume One, Chapter 4, Window Attributes).  If a mapped window is made smaller, exposure events will be generated on windows that it formerly obscured.  If the override_redirect attribute of the window is False and the window manager has selected SubstructureRedirectMask on the parent, then a ConfigureRequest event is sent to the window manager, and no further processing is performed.  If the client has selected StructureNotifyMask on the window, then a ConfigureNotify event is generated after the move takes place, and the event will contain the final size of the window. 

Errors

BadValueEither width or height is zero. 

BadWindow

See Also

XCirculateSubwindows(), XCirculateSubwindowsDown(), XCirculateSubwindowsUp(), XConfigureWindow(), XLowerWindow(), XMoveResizeWindow(), XMoveWindow(), XQueryTree(), XRaiseWindow(), XReparentWindow(), XRestackWindows(). 

Copyright O’Reilly & Assoc.  —