XRotateWindowProperties(display, w, properties, num_prop, npositions)
Display *display;
Windoww;
Atomproperties[];
int num_prop;
int npositions;
Arguments
display
Specifies the connection to the X server.
w
Specifies the window.
properties
Specifies the array of properties that are to be rotated.
num_prop
Specifies the length of the properties array.
npositions
Specifies the rotation amount.
Description
The
XRotateWindowProperties()
function allows you to rotate properties on a window and causes
the X server to generate
PropertyNotify
events.
If the property names in the properties array are viewed as being numbered
starting from zero 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 N for all I from zero to N - 1.
The effect is to rotate the states by npositions places around the virtual ring
of property names (right for positive npositions,
left for negative npositions).
If npositions mod N is nonzero,
the X server generates a
PropertyNotify
event for each property in the order that they are listed in the array.
If an atom occurs more than once in the list or no property with that
name is defined for the window,
a
BadMatch
error results.
If a
BadAtom
or
BadMatch
error results,
no properties are changed.
XRotateWindowProperties()
can generate
BadAtom ,
BadMatch ,
and
BadWindow
errors.
Diagnostics
BadAtom
A value for an Atom argument does not name a
defined Atom.