XConfigureWindow(3X) XConfigureWindow(3X)
NAME
XConfigureWindow, XMoveWindow, XResizeWindow,
XMoveResizeWindow, XSetWindowBorderWidth - configure
windows
SYNOPSIS
XConfigureWindow(display, w, value_mask, values)
Display *display;
Window w;
unsigned int value_mask;
XWindowChanges *values;
XMoveWindow(display, w, x, y)
Display *display;
Window w;
int x, y;
XResizeWindow(display, w, width, height)
Display *display;
Window w;
unsigned int width, height;
XMoveResizeWindow(display, w, x, y, width, height)
Display *display;
Window w;
int x, y;
unsigned int width, height;
XSetWindowBorderWidth(display, w, width)
Display *display;
Window w;
unsigned int width;
ARGUMENTS
display Specifies the connection to the X server.
value_mask
Specifies which values are to be set using
information in the values structure. This
mask is the bitwise inclusive OR of the valid
configure window values bits.
values Specifies a pointer to the XWindowChanges
structure.
w Specifies the window to be reconfigured,
moved, or resized..
width Specifies the width of the window border.
width
height Specify the width and height, which are the
- 1 -
XConfigureWindow(3X) XConfigureWindow(3X)
interior dimensions of the window.
x
y Specify the x and y coordinates, which define
the new location of the top-left pixel of the
window's border or the window itself if it
has no border or define the new position of
the window relative to its parent.
DESCRIPTION
The XConfigureWindow function uses the values specified
in the XWindowChanges structure to reconfigure a
window's size, position, border, and stacking order.
Values not specified are taken from the existing
geometry of the window.
If a sibling is specified without a stack_mode or if
the window is not actually a sibling, a BadMatch error
results. Note that the computations for BottomIf,
TopIf, and Opposite are performed with respect to the
window's final geometry (as controlled by the other
arguments passed to XConfigureWindow), not its initial
geometry. Any backing store contents of the window,
its inferiors, and other newly visible windows are
either discarded or changed to reflect the current
screen contents (depending on the implementation).
XConfigureWindow can generate BadMatch, BadValue, and
BadWindow errors.
The XMoveWindow function moves the specified window to
the specified x and y coordinates, but it does not
change the window's size, raise the window, or change
the mapping state of the window. Moving a mapped
window may or may not lose the window's contents
depending on if the window is obscured by nonchildren
and if no backing store exists. If the contents of the
window are lost, the X server generates Expose events.
Moving a mapped window generates Expose events on any
formerly obscured windows.
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. Otherwise, the window is
moved.
XMoveWindow can generate a BadWindow error.
The XResizeWindow function changes the inside
dimensions of the specified window, not including its
- 2 -
XConfigureWindow(3X) XConfigureWindow(3X)
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.
The XMoveResizeWindow function changes the size and
location of the specified window without raising it.
Moving and resizing a mapped window may generate an
Expose event on the window. Depending on the new size
and location parameters, moving and resizing a window
may generate Expose events on windows that the 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. Otherwise, the window size and
location are changed.
XMoveResizeWindow can generate BadValue and BadWindow
errors.
The XSetWindowBorderWidth function sets the specified
window's border width to the specified width.
XSetWindowBorderWidth can generate a BadWindow error.
DIAGNOSTICS
BadMatch An InputOnly window is used as a Drawable.
BadMatch Some argument or pair of arguments has the
correct type and range but fails to match in
some other way required by the request.
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
- 3 -
XConfigureWindow(3X) XConfigureWindow(3X)
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(3X11), XCreateWindow(3X11),
XDestroyWindow(3X11), XMapWindow(3X11),
XRaiseWindow(3X11), XUnmapWindow(3X11)
Xlib Programming Manual
- 4 -