XChangeWindowAttributes(3X) — X Version 11

NAME

XChangeWindowAttributes, XSetWindowBackground, XSetWindowBackgroundPixmap, XSetWindowBorder, XSetWindowBorderPixmap − change window attributes

SYNTAX

XChangeWindowAttributes(display, w, valuemask, attributes)
      Display ∗display;
      Window w;
      unsigned long valuemask;
      XSetWindowAttributes ∗attributes;

XSetWindowBackground(display, w, background_pixel)
      Display ∗display;
      Window w;
      unsigned long background_pixel;

XSetWindowBackgroundPixmap(display, w, background_pixmap)
      Display ∗display;
      Window w;
      Pixmap background_pixmap;

XSetWindowBorder(display, w, border_pixel)
      Display ∗display;
      Window w;
      unsigned long border_pixel;

XSetWindowBorderPixmap(display, w, border_pixmap)
      Display ∗display;
      Window w;
      Pixmap border_pixmap;

ARGUMENTS

attributesAttributes of the window to be set at creation time should be set in this structure. The valuemask should have the appropriate bits set to indicate which attributes have been set in the structure.

background_pixel
Specifies the pixel of the background. This pixel value determines which entry in the color map is used.

background_pixmap
Specifies the background pixmap. If a Pixmap ID is specified, the background is painted with this pixmap. If None, no background is painted. If ParentRelative, the parent’s pixmap is used.

border_pixelSpecifies the entry in the color map.

border_pixmap
Specifies the border pixmap. If you specify a pixmap ID, the associated pixmap is used for the border. If CopyFromParent is specified, a copy of the parent window’s border pixmap is used.

displaySpecifies the connection to the X server.

valuemaskSpecifies which window attributes are defined in the attributes argument. This mask is the bitwise inclusive OR of the valid attribute mask bits. If valuemask is zero, the attributes are ignored and are not referenced.

wSpecifies the window ID.

DESCRIPTION

Depending on the valuemask, the XChangeWindowAttributes function uses the window attributes in the XSetWindowAttributes structure to change the specified window attributes. .PN XChangeWindowAttributes can generate BadAccess, BadColor, BadCursor, BadMatch, BadPixmap, BadValue, and BadWindow errors.

The XSetWindowBackground function sets the background pixel of the window to the pixel value you specify. .PN XSetWindowBackground can generate BadMatch and BadWindow errors.

The XSetWindowBackgroundPixmap function sets the background pixmap of the window to the pixmap you specify. .PN XSetWindowBackgroundPixmap can generate BadColor, BadMatch, BadPixmap, and BadWindow errors.

The XSetWindowBorder function sets the border pixel of the window to the pixel value you specify. It uses this value as an entry into the color map to determine which color is to be used to paint the border. .PN XSetWindowBorder can generate BadMatch, BadPixmap, BadValue, and BadWindow errors.

The XSetWindowBorderPixmap function sets the border pixmap of the window to the pixmap you specify. It uses this entry for the border. .PN XSetWindowBorderPixmap can generate BadMatch, BadPixmap, BadValue, and BadWindow errors.

DIAGNOSTICS

BadAccess A client attempted to free a color map entry that it did not already allocate.

BadAccess A client attempted to store into a read-only color map entry.

BadColor A value for a Colormap argument does not name a defined Colormap.

BadCursor A value for a Cursor argument does not name a defined Cursor.

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.

BadMatch An InputOnly window locks this attribute.

BadPixmap A value for a Pixmap argument does not name a defined Pixmap.

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