XRotateWindowProperties()XRotateWindowProperties()NameXRotateWindowProperties – 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.
DescriptionXRotateWindowProperties() rotates the contents of an array of proper‐
ties 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 nposi‐
tion).
If npositions mod num_prop is non-zero, a PropertyNotify event is gen‐
erated 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 AlsoXChangeProperty(), XDeleteProperty(), XGetAtomName(), XGetFontProp‐
erty(), XGetWindowProperty(), XInternAtom(), XListProperties(), XSet‐
StandardProperties().
Xlib - Properties XRotateWindowProperties()