XChangeWindowAttributes, XSetWindowBackground, XSetWindow-
BackgroundPixmap, XSetWindowBorder, XSetWindowBorder-
Pixmap, XSetWindowColormap - 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;
XSetWindowColormap(display, w, colormap)
Display *display;
Window w;
Colormap colormap;
ARGUMENTS
attributes
Specifies the structure from which the values
(as specified by the value mask) are to be
taken. The value mask should have the appropri-
ate bits set to indicate which attributes have
been set in the structure.
background_pixel
Specifies the pixel that is to be used for the
background.
background_pixmap
Specifies the background pixmap, ParentRelative,
or None.
w Specifies the window.
colormap Specifies the colormap.
DESCRIPTION
Depending on the valuemask, the XChangeWindowAttributes
function uses the window attributes in the XSetWindowAt-
tributes structure to change the specified window
attributes. Changing the background does not cause the
window contents to be changed. To repaint the window and
its background, use XClearWindow. Setting the border or
changing the background such that the border tile origin
changes causes the border to be repainted. Changing the
background of a root window to None or ParentRelative
restores the default background pixmap. Changing the bor-
der of a root window to CopyFromParent restores the
default border pixmap. Changing the win-gravity does not
affect the current position of the window. Changing the
backing-store of an obscured window to WhenMapped or
Always, or changing the backing-planes, backing-pixel, or
save-under of a mapped window may have no immediate
effect. Changing the colormap of a window (that is,
defining a new map, not changing the contents of the
existing map) generates a ColormapNotify event. Changing
the colormap of a visible window may have no immediate
effect on the screen because the map may not be installed
(see XInstallColormap). Changing the cursor of a root
window to None restores the default cursor. Whenever pos-
sible, you are encouraged to share colormaps.
Multiple clients can select input on the same window.
Their event masks are maintained separately. When an
event is generated, it is reported to all interested
clients. However, only one client at a time can select
for SubstructureRedirectMask, ResizeRedirectMask, and
ButtonPressMask. If a client attempts to select any of
these event masks and some other client has already
selected one, a BadAccess error results. There is only
one do-not-propagate-mask for a window, not one per
client.
XChangeWindowAttributes can generate BadAccess, BadColor,
BadCursor, BadMatch, BadPixmap, BadValue, and BadWindow
errors.
The XSetWindowBackground function sets the background of
the window to the specified pixel value. Changing the
background does not cause the window contents to be
changed. XSetWindowBackground uses a pixmap of undefined
size filled with the pixel value you passed. If you try
to change the background of an InputOnly window, a Bad-
Match error results.
XSetWindowBackgroundPixmap can generate BadMatch,
BadPixmap, and BadWindow errors.
The XSetWindowBorder function sets the border of the win-
dow to the pixel value you specify. If you attempt to
perform this on an InputOnly window, a BadMatch error
results.
XSetWindowBorder can generate BadMatch and BadWindow
errors.
The XSetWindowBorderPixmap function sets the border pixmap
of the window to the pixmap you specify. The border
pixmap can be freed immediately if no further explicit
references to it are to be made. If you specify
CopyFromParent, a copy of the parent window's border
pixmap is used. If you attempt to perform this on an
InputOnly window, a BadMatch error results.
XSetWindowBorderPixmap can generate BadMatch, BadPixmap,
and BadWindow errors.
The XSetWindowColormap function sets the specified col-
ormap of the specified window. The colormap must have the
same visual type as the window, or a BadMatch error
results.
XSetWindowColormap can generate BadColor, BadMatch, 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 cor-
rect 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.
XRaiseWindow(3X11), XUnmapWindow(3X11)
Xlib - C Language X Interface
X Version 11 Release 6.4 1