Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

NAME

XSetWindowBorder − change a window border pixel value attribute and repaint the border. 

Synopsis

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

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

wSpecifies the window ID.  Must be an InputOutput window. 

border_pixel
Specifies the colormap entry with which the server will paint the border.

Description

XSetWindowBorder() sets the border_pixel attribute of window w to a pixel value, and repaints the border.  The border is also automatically repainted after Expose events.  Use XSetWindowBorderPixmap() to create a tiled border.  On top-level windows, the window manager often resets the border, so applications should not depend on their settings.  For more information, see Volume One, Chapter 4, Window Attributes. 

Errors

BadMatchSetting border of InputOnly window. 

BadWindow

See Also

XChangeWindowAttributes(), XGetGeometry(), XGetWindowAttributes(), XSetWindowBackground(), XSetWindowBackgroundPixmap(), XSetWindowBorderPixmap(). 

Copyright O’Reilly & Assoc.  —  

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026