hpux man page for xrotatewindowproperties

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()