XResizeWindow

Syntax

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

Arguments

display Specifies the connection to the X server.
w Specifies the window.
width
height
Specify the width and height, which are the interior dimensions of the window after the call completes.

Description

The XResizeWindow() function changes the inside dimensions of the specified window, not including its borders. This function does not change the window's upper-left coordinate or the origin and does not restack the window. Changing the size of a mapped window may lose its contents and generate Expose events. If a mapped window is made smaller, changing its size generates Expose events on windows that the mapped window formerly obscured.

If the override-redirect flag of the window is False and some other client has selected SubstructureRedirectMask on the parent, the X server generates a ConfigureRequest event, and no further processing is performed. If either width or height is zero, a BadValue error results.

XResizeWindow() can generate BadValue and BadWindow errors.

Diagnostics

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error.
BadWindow A value for a Window argument does not name a defined Window.

See also

XChangeWindowAttributes(), XConfigureWindow(), XCreateWindow(), XDestroyWindow(), XMapWindow(), XMoveResizeWindow(), XMoveWindow(), XRaiseWindow(), XSetWindowBorderWidth(), XUnmapWindow(), "Configuring Windows"
Christophe Tronche, ch@tronche.com