XRotateWindowProperties() XRotateWindowProperties()
Name
XRotateWindowProperties - rotate properties in the properties array.
Synopsis
XRotateWindowProperties(display, w, properties, num_prop, npositions)
Display *display;
Window w;
Atom properties[];
int num_prop;
int npositions;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the ID of the window whose properties are to be rearranged.
properties
Specifies the list of properties to be rotated.
num_prop Specifies the length of the properties array.
npositions
Specifies the number of positions to rotate the property list. The sign controls the direction of rotation.
Description
XRotateWindowProperties() rotates the contents of an array of properties on a window. If the property names in the properties array are
viewed as if they were numbered starting from 0 and if there are num_prop property names in the list, then the value associated with prop-
erty name I becomes the value associated with property name (I + npositions) mod num_prop, for all I from 0 to num_prop - 1. Therefore,
the sign of npositions controls the direction of rotation. The effect is to rotate the states by npositions places around the virtual ring
of property names (right for positive npositions, left for negative nposition).
If npositions mod num_prop is non-zero, a PropertyNotify event is generated for each property, in the order listed.
If a BadAtom, BadMatch, or BadWindow error is generated, no properties are changed.
Errors
BadAtom Undefined atom in the property list.
BadMatch An atom appears more that once in the list or no property with that name is defined for the window.
BadWindow
See Also
XChangeProperty(), XDeleteProperty(), XGetAtomName(), XGetFontProperty(), XGetWindowProperty(), XInternAtom(), XListProperties(), XSetStan-
dardProperties().
Xlib - Properties XRotateWindowProperties()
