NAME
XSetWindowBackground − set the background pixel value attribute of a window.
Synopsis
XSetWindowBackground(display, w, background_pixel)
Display *display;
Window w;
unsigned long background_pixel;
Arguments
displaySpecifies a connection to an X server; returned from XOpenDisplay().
wSpecifies the window ID. Must be an InputOutput window.
background_pixel
Specifies which entry in the colormap is used as the background color. The constant CopyFromParent is NOT valid.
Description
XSetWindowBackground() sets the background attribute of a window, setting the pixel value to be used to fill the background. This overrides any previous call to XSetWindowBackground or XSetWindowBackgroundPixmap() on the same window. XSetWindowBackground() does not change the current window contents immediately. The background is automatically repainted after Expose events. You can also redraw the background without Expose events by calling XClearWindow() immediately after. For more information, see Volume One, Chapter 4, Window Attributes.
Errors
BadMatchSetting background of InputOnly window.
BadWindow
See Also
XChangeWindowAttributes(), XGetGeometry(), XGetWindowAttributes(), XSetWindowBackgroundPixmap(), XSetWindowBorder(), XSetWindowBorderPixmap().
Copyright O’Reilly & Assoc. —