XSetWindowBorderPixmap
Syntax
XSetWindowBorderPixmap(display, w, border_pixmap)
Display *display;
Window w;
Pixmap border_pixmap;
Arguments
| display
| Specifies the connection to the X server.
|
| w
| Specifies the window.
|
| border_pixmap
| Specifies the border pixmap or
CopyFromParent.
|
Description
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.
Ifyou specify
.PN 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.
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.
|
| BadPixmap
| A value for a Pixmap argument does not name a
defined Pixmap.
|
| BadWindow
| A value for a Window argument does not name a defined Window.
|
See also
XChangeWindowAttributes(),
XConfigureWindow(),
XCreateWindow(),
XDestroyWindow(),
XInstallColormap(),
XMapWindow(),
XRaiseWindow(),
XSetWindowBackground(),
XSetWindowBackgroundPixmap(),
XSetWindowBorder(),
XSetWindowColormap(),
XUnmapWindow(),
"Changing Window Attributes"
Christophe Tronche, ch@tronche.com