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

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

wSpecifies the ID of the window whose properties are to be rearranged. 

properties
Specifies the list of properties to be rotated.

num_propSpecifies 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 property 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 nonzero, 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

BadAtomUndefined atom in the property list. 

BadMatchAn atom appears more that once in the list or no property with that name is defined for the window. 

BadWindow

See Also

XChangeProperty(), XDeleteProperty(), XGetFontProperty(), XGetWindowProperty(), XInternAtom(), XListProperties(), XSetStandardProperties(). 

Copyright O’Reilly & Assoc.  —