]> git.decadent.org.uk Git - ion3-doc.git/blobdiff - ionconf/node6.html
Merge commit '20080103' into HEAD
[ion3-doc.git] / ionconf / node6.html
index 7baa979c00be598aa0b2fa0fa9de890c072a6bbd..200471fca2d1391051b539c7480523b007e0dec4 100644 (file)
@@ -28,31 +28,31 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 <BODY >
 
 <DIV CLASS="navigation"><!--Navigation Panel-->
-<A NAME="tex2html363"
+<A NAME="tex2html362"
   HREF="node7.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html357"
+<A NAME="tex2html356"
   HREF="ionconf.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html351"
+<A NAME="tex2html350"
   HREF="node5.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html359"
+<A NAME="tex2html358"
   HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> 
-<A NAME="tex2html361"
+<A NAME="tex2html360"
   HREF="node11.html">
 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> 
 <BR>
-<B> Next:</B> <A NAME="tex2html364"
+<B> Next:</B> <A NAME="tex2html363"
   HREF="node7.html">6. Function reference</A>
-<B> Up:</B> <A NAME="tex2html358"
+<B> Up:</B> <A NAME="tex2html357"
   HREF="ionconf.html">Configuring and extending Ion3</A>
-<B> Previous:</B> <A NAME="tex2html352"
+<B> Previous:</B> <A NAME="tex2html351"
   HREF="node5.html">4. Graphical styles</A>
- &nbsp; <B>  <A NAME="tex2html360"
+ &nbsp; <B>  <A NAME="tex2html359"
   HREF="node1.html">Contents</A></B> 
- &nbsp; <B>  <A NAME="tex2html362"
+ &nbsp; <B>  <A NAME="tex2html361"
   HREF="node11.html">Index</A></B> 
 <BR>
 <BR></DIV>
@@ -61,20 +61,20 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
 
 <UL CLASS="ChildLinks">
-<LI><A NAME="tex2html365"
+<LI><A NAME="tex2html364"
   HREF="node6.html#SECTION00610000000000000000"><SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN> Hooks</A>
-<LI><A NAME="tex2html366"
+<LI><A NAME="tex2html365"
   HREF="node6.html#SECTION00620000000000000000"><SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN> Referring to regions</A>
 <UL>
-<LI><A NAME="tex2html367"
+<LI><A NAME="tex2html366"
   HREF="node6.html#SECTION00621000000000000000"><SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN> Direct object references</A>
-<LI><A NAME="tex2html368"
+<LI><A NAME="tex2html367"
   HREF="node6.html#SECTION00622000000000000000"><SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN> Name-based lookups</A>
 </UL>
 <BR>
-<LI><A NAME="tex2html369"
+<LI><A NAME="tex2html368"
   HREF="node6.html#SECTION00630000000000000000"><SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">3</SPAN> Alternative winprop selection criteria</A>
-<LI><A NAME="tex2html370"
+<LI><A NAME="tex2html369"
   HREF="node6.html#SECTION00640000000000000000"><SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">4</SPAN> Writing <TT>ion-statusd</TT> monitors</A>
 </UL>
 <!--End of Table of Child-Links-->
@@ -201,13 +201,16 @@ region, use <A HREF="node7.html#fn:WRegion.set_name"><TT>WRegion.set_name</TT></
 It is possible to write more complex winprop selection routines than
 those described in section <A HREF="node4.html#sec:winprops">3.5</A>. To match a particular
 winprop using whatever way you want to, just set the <TT>match</TT>
-field of the winprop to a function that receives the client window
-as its sole parameter, and that returns <TT>true</TT> if the winprop
-matches, and <TT>false</TT> otherwise.
+field of the winprop to a function that receives the as its parameters
+the triple <TT>(prop, cwin, id)</TT>, where <TT>prop</TT> is the table for 
+the winprop itself, <TT>cwin</TT> is the client window object,
+and  <TT>id</TT> is the <A HREF="node7.html#fn:WClientWin.get_ident"><TT>WClientWin.get_ident</TT></A> result.
+The function should return <TT>true</TT> if the winprop matches, 
+and <TT>false</TT> otherwise. Note that the <TT>match</TT> function
+is only called after matching against class/role/instance.
 
 <P>
-The class, instance and role properties can be obtained with
-<A HREF="node7.html#fn:WClientWin.get_ident"><TT>WClientWin.get_ident</TT></A>, and the title with <A HREF="node7.html#fn:WRegion.name"><TT>WRegion.name</TT></A>.
+The title of a client window can be obtained with <A HREF="node7.html#fn:WRegion.name"><TT>WRegion.name</TT></A>.
 If you want to match against (almost) arbitrary window properties,
 have a look at the documentation for the following functions, and
 their standard Xlib counterparts: <A HREF="node7.html#fn:ioncore.x_intern_atom"><TT>ioncore.x_intern_atom</TT></A>
@@ -320,31 +323,31 @@ local settings=table.join(statusd.get_config("foo"), defaults)
 
 <DIV CLASS="navigation"><HR>
 <!--Navigation Panel-->
-<A NAME="tex2html363"
+<A NAME="tex2html362"
   HREF="node7.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html357"
+<A NAME="tex2html356"
   HREF="ionconf.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html351"
+<A NAME="tex2html350"
   HREF="node5.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html359"
+<A NAME="tex2html358"
   HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> 
-<A NAME="tex2html361"
+<A NAME="tex2html360"
   HREF="node11.html">
 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> 
 <BR>
-<B> Next:</B> <A NAME="tex2html364"
+<B> Next:</B> <A NAME="tex2html363"
   HREF="node7.html">6. Function reference</A>
-<B> Up:</B> <A NAME="tex2html358"
+<B> Up:</B> <A NAME="tex2html357"
   HREF="ionconf.html">Configuring and extending Ion3</A>
-<B> Previous:</B> <A NAME="tex2html352"
+<B> Previous:</B> <A NAME="tex2html351"
   HREF="node5.html">4. Graphical styles</A>
- &nbsp; <B>  <A NAME="tex2html360"
+ &nbsp; <B>  <A NAME="tex2html359"
   HREF="node1.html">Contents</A></B> 
- &nbsp; <B>  <A NAME="tex2html362"
+ &nbsp; <B>  <A NAME="tex2html361"
   HREF="node11.html">Index</A></B> </DIV>
 <!--End of Navigation Panel-->