📄 xrotatewindowproperties.html
字号:
<HTML><HEAD><TITLE>Xlib Programming Manual: XRotateWindowProperties</TITLE></HEAD><BODY><H1 ALIGN=center>XRotateWindowProperties</H1><H2>Syntax</H2><!.IN "XRotateWindowProperties" "" "@DEF@"><CODE><PRE>XRotateWindowProperties(<B>display</B>, <B>w</B>, <B>properties</B>, <B>num_prop</B>, <B>npositions</B>) <A HREF="../display/opening.html#Display">Display</A> *<B>display</B>; <A HREF="../window/">Window</A> <B>w</B>; <A HREF="properties-and-atoms.html">Atom</A> <B>properties</B>[]; int <B>num_prop</B>; int <B>npositions</B>;</PRE></CODE><H2>Arguments</H2><TABLE><TR><TD> <B>display</B><TD> Specifies the connection to the X server.<TR><TD> <B>w</B><TD> Specifies the window.<TR><TD> <B>properties</B><TD> Specifies the array of properties that are to be rotated.<TR><TD> <B>num_prop</B><TD> Specifies the length of the properties array.<TR><TD> <B>npositions</B><TD> Specifies the rotation amount.</TABLE><H2>Description</H2>The<B>XRotateWindowProperties()</B>function allows you to rotate properties on a window and causesthe X server to generate<B><A HREF="../events/PropertyNotify.html">PropertyNotify</A></B>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 <CODE>(I + npositions) mod N</CODE> for all <CODE>I</CODE> from zero to <CODE>N - 1</CODE>.The effect is to rotate the states by npositions places around the virtual ringof property names (right for positive npositions, left for negative npositions).If npositions mod N is nonzero,the X server generates a<B><A HREF="../events/PropertyNotify.html">PropertyNotify</A></B>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 <B>BadMatch</B> error results.If a <B>BadAtom</B> or <B>BadMatch</B> error results,no properties are changed.<P><B>XRotateWindowProperties()</B>can generate<B>BadAtom</B> ,<B>BadMatch</B> ,and<B>BadWindow</B> errors.<H2>Diagnostics</H2><TABLE><TR><TD><B>BadAtom</B><TD> A value for an Atom argument does not name a defined Atom.<TR><TD><B>BadMatch</B><TD>An<B><A HREF="../window/create.html#InputClass">InputOnly</A></B>window is used as a Drawable.<TR><TD><B>BadMatch</B><TD>Some argument or pair of arguments has the correct type and range but fails to match in some other way required by the request. <TR><TD><B>BadPixmap</B><TD> A value for a Pixmap argument does not name a defined Pixmap.<TR><TD><B>BadWindow</B><TD>A value for a Window argument does not name a defined Window.</TABLE><H2>See also</H2><B><A HREF="XChangeProperty.html">XChangeProperty()</A></B>,<B><A HREF="XDeleteProperty.html">XDeleteProperty()</A></B>,<B><A HREF="XGetWindowProperty.html">XGetWindowProperty()</A></B>,<B><A HREF="XListProperties.html">XListProperties()</A></B>,"<A HREF="obtain-properties.html">Obtaining and Changing Window Properties</A>"<HR><ADDRESS><A HREF="http://tronche.com/">Christophe Tronche</A>, <A HREF="mailto:ch.tronche@computer.org">ch.tronche@computer.org</A></ADDRESS></BODY></HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -