XConfigureWindow(3X) — X Version 11

NAME

XConfigureWindow, XMoveWindow, XResizeWindow, XMoveResizeWindow, XSetWindowBorderWidth − configure windows

SYNTAX

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

displaySpecifies the connection to the X server.

value_maskSpecifies which values are to be set using information in the values structure. This mask is the bitwise inclusive OR of the valid change window values bits.

valuesSpecifies a pointer to the structure XWindowChanges.

wSpecifies the window ID.

width

heightSpecify the width and height.

ySpecify the x and y coordinates.

DESCRIPTION

The XConfigureWindow function uses the values specified in the XWindowChanges structure to reconfigure a window’s size, position, border, and stacking order. .PN XConfigureWindow can generate BadMatch, BadValue, and BadWindow errors.

The XMoveWindow function moves the specified window to the specified x and y coordinates. This function does not change the window’s size, does not raise the window, and does not change the mapping state of the window. .PN XMoveWindow can generate a BadWindow error.

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 raise the window. .PN XResizeWindow can generate a BadWindow error.

The XMoveResizeWindow function changes the size and location of the specified window without raising it. .PN XMoveResizeWindow can generate BadMatch, BadValue, and BadWindow errors.

The XSetWindowBorderWidth function sets the specified window’s border width to the specified width. .PN XSetWindowBorderWidth can generate BadValue and BadWindow errors.

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 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.

Museum