XSetWindowBorderPixmap man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



XChangeWindowAttributes(3XXLIB FUNCTXChangeWindowAttributes(3X11)

NAME
       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.

X Version 11		Release 6.4				1

XChangeWindowAttributes(3XXLIB FUNCTXChangeWindowAttributes(3X11)

       border_pixel
		 Specifies the entry in the colormap.

       border_pixmap
		 Specifies the border pixmap or CopyFromParent.

       display	Specifies the connection to the X server.

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

       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.

X Version 11		Release 6.4				2

XChangeWindowAttributes(3XXLIB FUNCTXChangeWindowAttributes(3X11)

       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.

       XSetWindowBackground can generate BadMatch and BadWindow
       errors.

       The XSetWindowBackgroundPixmap function sets the back-
       ground pixmap of the window to the specified pixmap.  The
       background pixmap can immediately be freed if no further
       explicit references to it are to be made.  If ParentRela-
       tive is specified, the background pixmap of the window's
       parent is used, or on the root window, the default back-
       ground is restored.  If you try to change the background
       of an InputOnly window, a BadMatch error results.  If the
       background is set to None, the window has no defined back-
       ground.

       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

X Version 11		Release 6.4				3

XChangeWindowAttributes(3XXLIB FUNCTXChangeWindowAttributes(3X11)

       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.

       BadValue Some numeric value falls outside the range of
		 values accepted by the request.  Unless a spe-
		 cific 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.

SEE ALSO
       XConfigureWindow(3X11), XCreateWindow(3X11), XDestroyWin-
       dow(3X11), XInstallColormap(3X11), XMapWindow(3X11),
       XRaiseWindow(3X11), XUnmapWindow(3X11)
       Xlib - C Language X Interface

X Version 11		Release 6.4				4

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net