diff options
| -rw-r--r-- | doc/treectrl.html | 432 | ||||
| -rw-r--r-- | doc/treectrl.man | 89 | ||||
| -rw-r--r-- | doc/treectrl.n | 95 |
3 files changed, 329 insertions, 287 deletions
diff --git a/doc/treectrl.html b/doc/treectrl.html index fa30d1e..100601e 100644 --- a/doc/treectrl.html +++ b/doc/treectrl.html @@ -1,10 +1,10 @@ -<! -- Copyright (c) 2002-2003 Christian Krone. -- -- See the file "license.terms" for information on usage and redistribution -- of this file, and for a DISCLAIMER OF ALL WARRANTIES. -- -- $Id: treectrl.html,v 1.7 2004/08/09 02:40:43 treectrl Exp $ +<! -- Copyright (c) 2002-2003 Christian Krone. -- -- See the file "license.terms" for information on usage and redistribution -- of this file, and for a DISCLAIMER OF ALL WARRANTIES. -- -- $Id: treectrl.html,v 1.8 2004/08/11 00:29:55 treectrl Exp $ --><html><head> <title>treectrl - Tk Commands </title> </head> <! -- Generated from file 'doc/treectrl.man' by tcllib/doctools with format 'html' --> -<! -- CVS: $Id: treectrl.html,v 1.7 2004/08/09 02:40:43 treectrl Exp $ treectrl.n +<! -- CVS: $Id: treectrl.html,v 1.8 2004/08/11 00:29:55 treectrl Exp $ treectrl.n --> <body> @@ -65,89 +65,92 @@ package require <b>treectrl 1.0</b><br> <tr valign=top ><td ><a href="#44"><i class='arg'>pathName</i> <b class='cmd'>item bbox</b> <i class='arg'>itemDesc</i> ?<i class='arg'>column</i>? ?<i class='arg'>element</i>?</a></td></tr> <tr valign=top ><td ><a href="#45"><i class='arg'>pathName</i> <b class='cmd'>item cget</b> <i class='arg'>itemDesc</i> <i class='arg'>option</i></a></td></tr> <tr valign=top ><td ><a href="#46"><i class='arg'>pathName</i> <b class='cmd'>item children</b> <i class='arg'>itemDesc</i></a></td></tr> -<tr valign=top ><td ><a href="#47"><i class='arg'>pathName</i> <b class='cmd'>item complex</b> <i class='arg'>itemDesc</i> <i class='arg'>list</i> <i class='arg'>...</i></a></td></tr> -<tr valign=top ><td ><a href="#48"><i class='arg'>pathName</i> <b class='cmd'>item configure</b> <i class='arg'>itemDesc</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#49"><i class='arg'>pathName</i> <b class='cmd'>item create</b> ?<i class='arg'>option value ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#50"><i class='arg'>pathName</i> <b class='cmd'>item delete</b> <i class='arg'>first</i> ?<i class='arg'>last</i>?</a></td></tr> -<tr valign=top ><td ><a href="#51"><i class='arg'>pathName</i> <b class='cmd'>item dump</b> <i class='arg'>itemDesc</i></a></td></tr> -<tr valign=top ><td ><a href="#52"><i class='arg'>pathName</i> <b class='cmd'>item element</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> ?<i class='arg'>arg ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#53"><i class='arg'>pathName</i> <b class='cmd'>item element actual</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> <i class='arg'>option</i></a></td></tr> -<tr valign=top ><td ><a href="#54"><i class='arg'>pathName</i> <b class='cmd'>item element cget</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> <i class='arg'>option</i></a></td></tr> -<tr valign=top ><td ><a href="#55"><i class='arg'>pathName</i> <b class='cmd'>item element configure</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#56"><i class='arg'>pathName</i> <b class='cmd'>item firstchild</b> <i class='arg'>parent</i> ?<i class='arg'>child</i>?</a></td></tr> -<tr valign=top ><td ><a href="#57"><i class='arg'>pathName</i> <b class='cmd'>item index</b> <i class='arg'>itemDesc</i></a></td></tr> -<tr valign=top ><td ><a href="#58"><i class='arg'>pathName</i> <b class='cmd'>item isancestor</b> <i class='arg'>itemDesc</i> <i class='arg'>descendant</i></a></td></tr> -<tr valign=top ><td ><a href="#59"><i class='arg'>pathName</i> <b class='cmd'>item isopen</b> <i class='arg'>itemDesc</i></a></td></tr> -<tr valign=top ><td ><a href="#60"><i class='arg'>pathName</i> <b class='cmd'>item lastchild</b> <i class='arg'>parent</i> ?<i class='arg'>child</i>?</a></td></tr> -<tr valign=top ><td ><a href="#61"><i class='arg'>pathName</i> <b class='cmd'>item nextsibling</b> <i class='arg'>sibling</i> ?<i class='arg'>next</i>?</a></td></tr> -<tr valign=top ><td ><a href="#62"><i class='arg'>pathName</i> <b class='cmd'>item numchildren</b> <i class='arg'>itemDesc</i></a></td></tr> -<tr valign=top ><td ><a href="#63"><i class='arg'>pathName</i> <b class='cmd'>item parent</b> <i class='arg'>itemDesc</i></a></td></tr> -<tr valign=top ><td ><a href="#64"><i class='arg'>pathName</i> <b class='cmd'>item prevsibling</b> <i class='arg'>sibling</i> ?<i class='arg'>prev</i>?</a></td></tr> -<tr valign=top ><td ><a href="#65"><i class='arg'>pathName</i> <b class='cmd'>item remove</b> <i class='arg'>itemDesc</i></a></td></tr> -<tr valign=top ><td ><a href="#66"><i class='arg'>pathName</i> <b class='cmd'>item rnc</b> <i class='arg'>itemDesc</i></a></td></tr> -<tr valign=top ><td ><a href="#67"><i class='arg'>pathName</i> <b class='cmd'>item sort</b> <i class='arg'>itemDesc</i> ?<i class='arg'>option ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#68"><i class='arg'>pathName</i> <b class='cmd'>item state</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> ?<i class='arg'>arg ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#69"><i class='arg'>pathName</i> <b class='cmd'>item state forcolumn</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> ?<i class='arg'>stateDescList</i>?</a></td></tr> -<tr valign=top ><td ><a href="#70"><i class='arg'>pathName</i> <b class='cmd'>item state get</b> <i class='arg'>itemDesc</i> ?<i class='arg'>stateName ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#71"><i class='arg'>pathName</i> <b class='cmd'>item state set</b> <i class='arg'>itemDesc</i> ?<i class='arg'>lastItem</i>? ?<i class='arg'>stateDescList</i>?</a></td></tr> -<tr valign=top ><td ><a href="#72"><i class='arg'>pathName</i> <b class='cmd'>item style</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> ?<i class='arg'>arg ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#73"><i class='arg'>pathName</i> <b class='cmd'>item style elements</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i></a></td></tr> -<tr valign=top ><td ><a href="#74"><i class='arg'>pathName</i> <b class='cmd'>item style map</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>style</i> <i class='arg'>map</i></a></td></tr> -<tr valign=top ><td ><a href="#75"><i class='arg'>pathName</i> <b class='cmd'>item style set</b> <i class='arg'>itemDesc</i> ?<i class='arg'>column</i>? ?<i class='arg'>style</i>? ?<i class='arg'>column style ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#76"><i class='arg'>pathName</i> <b class='cmd'>item text</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> ?<i class='arg'>text</i>? ?<i class='arg'>column text ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#77"><i class='arg'>pathName</i> <b class='cmd'>marquee</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#78"><i class='arg'>pathName</i> <b class='cmd'>marquee anchor</b> ?<i class='arg'>x y</i>?</a></td></tr> -<tr valign=top ><td ><a href="#79"><i class='arg'>pathName</i> <b class='cmd'>marquee cget</b> <i class='arg'>option</i></a></td></tr> -<tr valign=top ><td ><a href="#80"><i class='arg'>pathName</i> <b class='cmd'>marquee configure</b> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#81"><i class='arg'>pathName</i> <b class='cmd'>marquee coords</b> ?<i class='arg'>x1 y1 x2 y2</i>?</a></td></tr> -<tr valign=top ><td ><a href="#82"><i class='arg'>pathName</i> <b class='cmd'>marquee corner</b> ?<i class='arg'>x y</i>?</a></td></tr> -<tr valign=top ><td ><a href="#83"><i class='arg'>pathName</i> <b class='cmd'>marquee identify</b></a></td></tr> -<tr valign=top ><td ><a href="#84"><i class='arg'>pathName</i> <b class='cmd'>notify</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#85"><i class='arg'>pathName</i> <b class='cmd'>notify bind</b> ?<i class='arg'>object</i>? ?<i class='arg'>pattern</i>? ?<i class='arg'>script</i>?</a></td></tr> -<tr valign=top ><td ><a href="#86"><i class='arg'>pathName</i> <b class='cmd'>notify configure</b> <i class='arg'>window</i> <i class='arg'>pattern</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#87"><i class='arg'>pathName</i> <b class='cmd'>notify detailnames</b> <i class='arg'>eventName</i></a></td></tr> -<tr valign=top ><td ><a href="#88"><i class='arg'>pathName</i> <b class='cmd'>notify eventnames</b></a></td></tr> -<tr valign=top ><td ><a href="#89"><i class='arg'>pathName</i> <b class='cmd'>notify generate</b> <i class='arg'>pattern</i> ?<i class='arg'>charMap</i>?</a></td></tr> -<tr valign=top ><td ><a href="#90"><i class='arg'>pathName</i> <b class='cmd'>notify install detail</b> <i class='arg'>eventName</i> <i class='arg'>detail</i> ?<i class='arg'>percentsCommand</i>?</a></td></tr> -<tr valign=top ><td ><a href="#91"><i class='arg'>pathName</i> <b class='cmd'>notify install event</b> <i class='arg'>eventName</i> ?<i class='arg'>percentsCommand</i>?</a></td></tr> -<tr valign=top ><td ><a href="#92"><i class='arg'>pathName</i> <b class='cmd'>notify linkage</b> <i class='arg'>eventName</i> ?<i class='arg'>detail</i>?</a></td></tr> -<tr valign=top ><td ><a href="#93"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall detail</b> <i class='arg'>eventName</i> <i class='arg'>detail</i></a></td></tr> -<tr valign=top ><td ><a href="#94"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall event</b> <i class='arg'>eventName</i></a></td></tr> -<tr valign=top ><td ><a href="#95"><i class='arg'>pathName</i> <b class='cmd'>numcolumns</b></a></td></tr> -<tr valign=top ><td ><a href="#96"><i class='arg'>pathName</i> <b class='cmd'>numitems</b></a></td></tr> -<tr valign=top ><td ><a href="#97"><i class='arg'>pathName</i> <b class='cmd'>orphans</b></a></td></tr> -<tr valign=top ><td ><a href="#98"><i class='arg'>pathName</i> <b class='cmd'>range</b> <i class='arg'>first</i> <i class='arg'>last</i></a></td></tr> -<tr valign=top ><td ><a href="#99"><i class='arg'>pathName</i> <b class='cmd'>state</b> <i class='arg'>option</i> ?<i class='arg'>stateName</i>?</a></td></tr> -<tr valign=top ><td ><a href="#100"><i class='arg'>pathName</i> <b class='cmd'>state define</b> <i class='arg'>stateName</i></a></td></tr> -<tr valign=top ><td ><a href="#101"><i class='arg'>pathName</i> <b class='cmd'>state linkage</b> <i class='arg'>stateName</i></a></td></tr> -<tr valign=top ><td ><a href="#102"><i class='arg'>pathName</i> <b class='cmd'>state names</b></a></td></tr> -<tr valign=top ><td ><a href="#103"><i class='arg'>pathName</i> <b class='cmd'>state undefine</b> ?<i class='arg'>stateName ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#104"><i class='arg'>pathName</i> <b class='cmd'>see</b> <i class='arg'>itemDesc</i></a></td></tr> -<tr valign=top ><td ><a href="#105"><i class='arg'>pathName</i> <b class='cmd'>selection</b> <i class='arg'>option</i> <i class='arg'>arg</i></a></td></tr> -<tr valign=top ><td ><a href="#106"><i class='arg'>pathName</i> <b class='cmd'>selection add</b> <i class='arg'>first</i> ?<i class='arg'>last</i>?</a></td></tr> -<tr valign=top ><td ><a href="#107"><i class='arg'>pathName</i> <b class='cmd'>selection anchor</b> ?<i class='arg'>itemDesc</i>?</a></td></tr> -<tr valign=top ><td ><a href="#108"><i class='arg'>pathName</i> <b class='cmd'>selection clear</b> ?<i class='arg'>first</i>? ?<i class='arg'>last</i>?</a></td></tr> -<tr valign=top ><td ><a href="#109"><i class='arg'>pathName</i> <b class='cmd'>selection count</b></a></td></tr> -<tr valign=top ><td ><a href="#110"><i class='arg'>pathName</i> <b class='cmd'>selection get</b></a></td></tr> -<tr valign=top ><td ><a href="#111"><i class='arg'>pathName</i> <b class='cmd'>selection includes</b> <i class='arg'>itemDesc</i></a></td></tr> -<tr valign=top ><td ><a href="#112"><i class='arg'>pathName</i> <b class='cmd'>selection modify</b> <i class='arg'>select</i> <i class='arg'>deselect</i></a></td></tr> -<tr valign=top ><td ><a href="#113"><i class='arg'>pathName</i> <b class='cmd'>style</b> <i class='arg'>option</i> ?<i class='arg'>element</i>? ?<i class='arg'>arg arg ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#114"><i class='arg'>pathName</i> <b class='cmd'>style cget</b> <i class='arg'>style</i> <i class='arg'>option</i></a></td></tr> -<tr valign=top ><td ><a href="#115"><i class='arg'>pathName</i> <b class='cmd'>style configure</b> <i class='arg'>style</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#116"><i class='arg'>pathName</i> <b class='cmd'>style create</b> <i class='arg'>style</i> ?<i class='arg'>option value ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#117"><i class='arg'>pathName</i> <b class='cmd'>style delete</b> ?<i class='arg'>style ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#118"><i class='arg'>pathName</i> <b class='cmd'>style elements</b> <i class='arg'>style</i> ?<i class='arg'>elementList</i>?</a></td></tr> -<tr valign=top ><td ><a href="#119"><i class='arg'>pathName</i> <b class='cmd'>style layout</b> <i class='arg'>style</i> <i class='arg'>element</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#120"><i class='arg'>pathName</i> <b class='cmd'>style names</b></a></td></tr> -<tr valign=top ><td ><a href="#121"><i class='arg'>pathName</i> <b class='cmd'>toggle</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#122"><i class='arg'>pathName</i> <b class='cmd'>xview</b> ?<i class='arg'>args</i>?</a></td></tr> -<tr valign=top ><td ><a href="#123"><i class='arg'>pathName</i> <b class='cmd'>xview</b></a></td></tr> -<tr valign=top ><td ><a href="#124"><i class='arg'>pathName</i> <b class='cmd'>xview moveto</b> <i class='arg'>fraction</i></a></td></tr> -<tr valign=top ><td ><a href="#125"><i class='arg'>pathName</i> <b class='cmd'>xview scroll</b> <i class='arg'>number</i> <i class='arg'>what</i></a></td></tr> -<tr valign=top ><td ><a href="#126"><i class='arg'>pathName</i> <b class='cmd'>yview</b> ?<i class='arg'>args</i>?</a></td></tr> -<tr valign=top ><td ><a href="#127"><i class='arg'>pathName</i> <b class='cmd'>yview</b></a></td></tr> -<tr valign=top ><td ><a href="#128"><i class='arg'>pathName</i> <b class='cmd'>yview moveto</b> <i class='arg'>fraction</i></a></td></tr> -<tr valign=top ><td ><a href="#129"><i class='arg'>pathName</i> <b class='cmd'>yview scroll</b> <i class='arg'>number</i> <i class='arg'>what</i></a></td></tr> +<tr valign=top ><td ><a href="#47"><i class='arg'>pathName</i> <b class='cmd'>item collapse</b> <i class='arg'>itemDesc</i> ?<strong>-recurse</strong>?</a></td></tr> +<tr valign=top ><td ><a href="#48"><i class='arg'>pathName</i> <b class='cmd'>item complex</b> <i class='arg'>itemDesc</i> <i class='arg'>list</i> <i class='arg'>...</i></a></td></tr> +<tr valign=top ><td ><a href="#49"><i class='arg'>pathName</i> <b class='cmd'>item configure</b> <i class='arg'>itemDesc</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#50"><i class='arg'>pathName</i> <b class='cmd'>item create</b> ?<i class='arg'>option value ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#51"><i class='arg'>pathName</i> <b class='cmd'>item delete</b> <i class='arg'>first</i> ?<i class='arg'>last</i>?</a></td></tr> +<tr valign=top ><td ><a href="#52"><i class='arg'>pathName</i> <b class='cmd'>item dump</b> <i class='arg'>itemDesc</i></a></td></tr> +<tr valign=top ><td ><a href="#53"><i class='arg'>pathName</i> <b class='cmd'>item element</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> ?<i class='arg'>arg ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#54"><i class='arg'>pathName</i> <b class='cmd'>item element actual</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> <i class='arg'>option</i></a></td></tr> +<tr valign=top ><td ><a href="#55"><i class='arg'>pathName</i> <b class='cmd'>item element cget</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> <i class='arg'>option</i></a></td></tr> +<tr valign=top ><td ><a href="#56"><i class='arg'>pathName</i> <b class='cmd'>item element configure</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#57"><i class='arg'>pathName</i> <b class='cmd'>item expand</b> <i class='arg'>itemDesc</i> ?<strong>-recurse</strong>?</a></td></tr> +<tr valign=top ><td ><a href="#58"><i class='arg'>pathName</i> <b class='cmd'>item firstchild</b> <i class='arg'>parent</i> ?<i class='arg'>child</i>?</a></td></tr> +<tr valign=top ><td ><a href="#59"><i class='arg'>pathName</i> <b class='cmd'>item index</b> <i class='arg'>itemDesc</i></a></td></tr> +<tr valign=top ><td ><a href="#60"><i class='arg'>pathName</i> <b class='cmd'>item isancestor</b> <i class='arg'>itemDesc</i> <i class='arg'>descendant</i></a></td></tr> +<tr valign=top ><td ><a href="#61"><i class='arg'>pathName</i> <b class='cmd'>item isopen</b> <i class='arg'>itemDesc</i></a></td></tr> +<tr valign=top ><td ><a href="#62"><i class='arg'>pathName</i> <b class='cmd'>item lastchild</b> <i class='arg'>parent</i> ?<i class='arg'>child</i>?</a></td></tr> +<tr valign=top ><td ><a href="#63"><i class='arg'>pathName</i> <b class='cmd'>item nextsibling</b> <i class='arg'>sibling</i> ?<i class='arg'>next</i>?</a></td></tr> +<tr valign=top ><td ><a href="#64"><i class='arg'>pathName</i> <b class='cmd'>item numchildren</b> <i class='arg'>itemDesc</i></a></td></tr> +<tr valign=top ><td ><a href="#65"><i class='arg'>pathName</i> <b class='cmd'>item parent</b> <i class='arg'>itemDesc</i></a></td></tr> +<tr valign=top ><td ><a href="#66"><i class='arg'>pathName</i> <b class='cmd'>item prevsibling</b> <i class='arg'>sibling</i> ?<i class='arg'>prev</i>?</a></td></tr> +<tr valign=top ><td ><a href="#67"><i class='arg'>pathName</i> <b class='cmd'>item remove</b> <i class='arg'>itemDesc</i></a></td></tr> +<tr valign=top ><td ><a href="#68"><i class='arg'>pathName</i> <b class='cmd'>item rnc</b> <i class='arg'>itemDesc</i></a></td></tr> +<tr valign=top ><td ><a href="#69"><i class='arg'>pathName</i> <b class='cmd'>item sort</b> <i class='arg'>itemDesc</i> ?<i class='arg'>option ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#70"><i class='arg'>pathName</i> <b class='cmd'>item state</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> ?<i class='arg'>arg ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#71"><i class='arg'>pathName</i> <b class='cmd'>item state forcolumn</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> ?<i class='arg'>stateDescList</i>?</a></td></tr> +<tr valign=top ><td ><a href="#72"><i class='arg'>pathName</i> <b class='cmd'>item state get</b> <i class='arg'>itemDesc</i> ?<i class='arg'>stateName ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#73"><i class='arg'>pathName</i> <b class='cmd'>item state set</b> <i class='arg'>itemDesc</i> ?<i class='arg'>lastItem</i>? ?<i class='arg'>stateDescList</i>?</a></td></tr> +<tr valign=top ><td ><a href="#74"><i class='arg'>pathName</i> <b class='cmd'>item style</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> ?<i class='arg'>arg ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#75"><i class='arg'>pathName</i> <b class='cmd'>item style elements</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i></a></td></tr> +<tr valign=top ><td ><a href="#76"><i class='arg'>pathName</i> <b class='cmd'>item style map</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>style</i> <i class='arg'>map</i></a></td></tr> +<tr valign=top ><td ><a href="#77"><i class='arg'>pathName</i> <b class='cmd'>item style set</b> <i class='arg'>itemDesc</i> ?<i class='arg'>column</i>? ?<i class='arg'>style</i>? ?<i class='arg'>column style ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#78"><i class='arg'>pathName</i> <b class='cmd'>item text</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> ?<i class='arg'>text</i>? ?<i class='arg'>column text ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#79"><i class='arg'>pathName</i> <b class='cmd'>item toggle</b> <i class='arg'>itemDesc</i> ?<strong>-recurse</strong>?</a></td></tr> +<tr valign=top ><td ><a href="#80"><i class='arg'>pathName</i> <b class='cmd'>marquee</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#81"><i class='arg'>pathName</i> <b class='cmd'>marquee anchor</b> ?<i class='arg'>x y</i>?</a></td></tr> +<tr valign=top ><td ><a href="#82"><i class='arg'>pathName</i> <b class='cmd'>marquee cget</b> <i class='arg'>option</i></a></td></tr> +<tr valign=top ><td ><a href="#83"><i class='arg'>pathName</i> <b class='cmd'>marquee configure</b> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#84"><i class='arg'>pathName</i> <b class='cmd'>marquee coords</b> ?<i class='arg'>x1 y1 x2 y2</i>?</a></td></tr> +<tr valign=top ><td ><a href="#85"><i class='arg'>pathName</i> <b class='cmd'>marquee corner</b> ?<i class='arg'>x y</i>?</a></td></tr> +<tr valign=top ><td ><a href="#86"><i class='arg'>pathName</i> <b class='cmd'>marquee identify</b></a></td></tr> +<tr valign=top ><td ><a href="#87"><i class='arg'>pathName</i> <b class='cmd'>notify</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#88"><i class='arg'>pathName</i> <b class='cmd'>notify bind</b> ?<i class='arg'>object</i>? ?<i class='arg'>pattern</i>? ?<i class='arg'>script</i>?</a></td></tr> +<tr valign=top ><td ><a href="#89"><i class='arg'>pathName</i> <b class='cmd'>notify configure</b> <i class='arg'>window</i> <i class='arg'>pattern</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#90"><i class='arg'>pathName</i> <b class='cmd'>notify detailnames</b> <i class='arg'>eventName</i></a></td></tr> +<tr valign=top ><td ><a href="#91"><i class='arg'>pathName</i> <b class='cmd'>notify eventnames</b></a></td></tr> +<tr valign=top ><td ><a href="#92"><i class='arg'>pathName</i> <b class='cmd'>notify generate</b> <i class='arg'>pattern</i> ?<i class='arg'>charMap</i>?</a></td></tr> +<tr valign=top ><td ><a href="#93"><i class='arg'>pathName</i> <b class='cmd'>notify install detail</b> <i class='arg'>eventName</i> <i class='arg'>detail</i> ?<i class='arg'>percentsCommand</i>?</a></td></tr> +<tr valign=top ><td ><a href="#94"><i class='arg'>pathName</i> <b class='cmd'>notify install event</b> <i class='arg'>eventName</i> ?<i class='arg'>percentsCommand</i>?</a></td></tr> +<tr valign=top ><td ><a href="#95"><i class='arg'>pathName</i> <b class='cmd'>notify linkage</b> <i class='arg'>eventName</i> ?<i class='arg'>detail</i>?</a></td></tr> +<tr valign=top ><td ><a href="#96"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall detail</b> <i class='arg'>eventName</i> <i class='arg'>detail</i></a></td></tr> +<tr valign=top ><td ><a href="#97"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall event</b> <i class='arg'>eventName</i></a></td></tr> +<tr valign=top ><td ><a href="#98"><i class='arg'>pathName</i> <b class='cmd'>numcolumns</b></a></td></tr> +<tr valign=top ><td ><a href="#99"><i class='arg'>pathName</i> <b class='cmd'>numitems</b></a></td></tr> +<tr valign=top ><td ><a href="#100"><i class='arg'>pathName</i> <b class='cmd'>orphans</b></a></td></tr> +<tr valign=top ><td ><a href="#101"><i class='arg'>pathName</i> <b class='cmd'>range</b> <i class='arg'>first</i> <i class='arg'>last</i></a></td></tr> +<tr valign=top ><td ><a href="#102"><i class='arg'>pathName</i> <b class='cmd'>state</b> <i class='arg'>option</i> ?<i class='arg'>stateName</i>?</a></td></tr> +<tr valign=top ><td ><a href="#103"><i class='arg'>pathName</i> <b class='cmd'>state define</b> <i class='arg'>stateName</i></a></td></tr> +<tr valign=top ><td ><a href="#104"><i class='arg'>pathName</i> <b class='cmd'>state linkage</b> <i class='arg'>stateName</i></a></td></tr> +<tr valign=top ><td ><a href="#105"><i class='arg'>pathName</i> <b class='cmd'>state names</b></a></td></tr> +<tr valign=top ><td ><a href="#106"><i class='arg'>pathName</i> <b class='cmd'>state undefine</b> ?<i class='arg'>stateName ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#107"><i class='arg'>pathName</i> <b class='cmd'>see</b> <i class='arg'>itemDesc</i></a></td></tr> +<tr valign=top ><td ><a href="#108"><i class='arg'>pathName</i> <b class='cmd'>selection</b> <i class='arg'>option</i> <i class='arg'>arg</i></a></td></tr> +<tr valign=top ><td ><a href="#109"><i class='arg'>pathName</i> <b class='cmd'>selection add</b> <i class='arg'>first</i> ?<i class='arg'>last</i>?</a></td></tr> +<tr valign=top ><td ><a href="#110"><i class='arg'>pathName</i> <b class='cmd'>selection anchor</b> ?<i class='arg'>itemDesc</i>?</a></td></tr> +<tr valign=top ><td ><a href="#111"><i class='arg'>pathName</i> <b class='cmd'>selection clear</b> ?<i class='arg'>first</i>? ?<i class='arg'>last</i>?</a></td></tr> +<tr valign=top ><td ><a href="#112"><i class='arg'>pathName</i> <b class='cmd'>selection count</b></a></td></tr> +<tr valign=top ><td ><a href="#113"><i class='arg'>pathName</i> <b class='cmd'>selection get</b></a></td></tr> +<tr valign=top ><td ><a href="#114"><i class='arg'>pathName</i> <b class='cmd'>selection includes</b> <i class='arg'>itemDesc</i></a></td></tr> +<tr valign=top ><td ><a href="#115"><i class='arg'>pathName</i> <b class='cmd'>selection modify</b> <i class='arg'>select</i> <i class='arg'>deselect</i></a></td></tr> +<tr valign=top ><td ><a href="#116"><i class='arg'>pathName</i> <b class='cmd'>style</b> <i class='arg'>option</i> ?<i class='arg'>element</i>? ?<i class='arg'>arg arg ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#117"><i class='arg'>pathName</i> <b class='cmd'>style cget</b> <i class='arg'>style</i> <i class='arg'>option</i></a></td></tr> +<tr valign=top ><td ><a href="#118"><i class='arg'>pathName</i> <b class='cmd'>style configure</b> <i class='arg'>style</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#119"><i class='arg'>pathName</i> <b class='cmd'>style create</b> <i class='arg'>style</i> ?<i class='arg'>option value ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#120"><i class='arg'>pathName</i> <b class='cmd'>style delete</b> ?<i class='arg'>style ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#121"><i class='arg'>pathName</i> <b class='cmd'>style elements</b> <i class='arg'>style</i> ?<i class='arg'>elementList</i>?</a></td></tr> +<tr valign=top ><td ><a href="#122"><i class='arg'>pathName</i> <b class='cmd'>style layout</b> <i class='arg'>style</i> <i class='arg'>element</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#123"><i class='arg'>pathName</i> <b class='cmd'>style names</b></a></td></tr> +<tr valign=top ><td ><a href="#124"><i class='arg'>pathName</i> <b class='cmd'>toggle</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#125"><i class='arg'>pathName</i> <b class='cmd'>xview</b> ?<i class='arg'>args</i>?</a></td></tr> +<tr valign=top ><td ><a href="#126"><i class='arg'>pathName</i> <b class='cmd'>xview</b></a></td></tr> +<tr valign=top ><td ><a href="#127"><i class='arg'>pathName</i> <b class='cmd'>xview moveto</b> <i class='arg'>fraction</i></a></td></tr> +<tr valign=top ><td ><a href="#128"><i class='arg'>pathName</i> <b class='cmd'>xview scroll</b> <i class='arg'>number</i> <i class='arg'>what</i></a></td></tr> +<tr valign=top ><td ><a href="#129"><i class='arg'>pathName</i> <b class='cmd'>yview</b> ?<i class='arg'>args</i>?</a></td></tr> +<tr valign=top ><td ><a href="#130"><i class='arg'>pathName</i> <b class='cmd'>yview</b></a></td></tr> +<tr valign=top ><td ><a href="#131"><i class='arg'>pathName</i> <b class='cmd'>yview moveto</b> <i class='arg'>fraction</i></a></td></tr> +<tr valign=top ><td ><a href="#132"><i class='arg'>pathName</i> <b class='cmd'>yview scroll</b> <i class='arg'>number</i> <i class='arg'>what</i></a></td></tr> </table></td></tr></table> <h2><a name="description">DESCRIPTION</a></h2> <p> @@ -604,22 +607,7 @@ command. <br><br> <dt><a name="6"><i class='arg'>pathName</i> <b class='cmd'>collapse</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a><dd> -Switches off the <strong>open</strong> state of the item(s) -described by <i class='arg'>itemDesc</i>. -If the item has descendants, they are no longer displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options <strong>-closedbuttonimage</strong> or <strong>-closedbuttonbitmap</strong>, -or a <em>+</em> sign if no image or bitmap is configured. -If the item is already closed, this command has no effect. -<i class='arg'>ItemDesc</i> may also be the string <strong>all</strong>, -in which case all items of the treectrl widget are collapsed. -If <strong>-recurse</strong> is specified, all descendants of <i class='arg'>itemDesc</i> -will also be collapsed. -For every item, that actually will be collapsed, -two events are generated: -a <strong><Collapse-before></strong> event before the item state is changed, -and a <strong><Collapse-after></strong> event after the item state was changed. +Use <b class='cmd'>item collapse</b> instead. <br><br> <dt><a name="7"><i class='arg'>pathName</i> <b class='cmd'>column</b> <i class='arg'>option</i> <i class='arg'>column</i> ?<i class='arg'>arg ...</i>?</a><dd> @@ -991,21 +979,7 @@ such as <strong>rect</strong> or <strong>text</strong>. <dt><a name="39"><i class='arg'>pathName</i> <b class='cmd'>expand</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a><dd> -Switches on the <strong>open</strong> state of the item(s) described by <i class='arg'>itemDesc</i>. -If the item has descendants, they are now displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options <strong>-openbuttonimage</strong> or <strong>-openbuttonbitmap</strong>, -or a <em>-</em> sign if no image or bitmap is configured. -If the item is already open, this command has no effect. -<i class='arg'>ItemDesc</i> may also be the string <strong>all</strong>, -in which case all items of the treectrl widget are expanded. -If <strong>-recurse</strong> is specified, all descendants of <i class='arg'>itemDesc</i> -will also be expanded. -For every item, that actually will be expanded, -two events are generated: -an <strong><Expand-before></strong> event before the item state is changed, -and an <strong><Expand-after></strong> event after the item state was changed. +Use <b class='cmd'>item expand</b> instead. <br><br> <dt><a name="40"><i class='arg'>pathName</i> <b class='cmd'>identify</b> <i class='arg'>x</i> <i class='arg'>y</i></a><dd> @@ -1093,7 +1067,27 @@ of the item specified by <i class='arg'>itemDesc</i> in the correct order from the first child to the last child. <br><br> -<dt><a name="47"><i class='arg'>pathName</i> <b class='cmd'>item complex</b> <i class='arg'>itemDesc</i> <i class='arg'>list</i> <i class='arg'>...</i></a><dd> +<dt><a name="47"><i class='arg'>pathName</i> <b class='cmd'>item collapse</b> <i class='arg'>itemDesc</i> ?<strong>-recurse</strong>?</a><dd> + +Switches off the <strong>open</strong> state of the item(s) +described by <i class='arg'>itemDesc</i>. +If the item has descendants, they are no longer displayed. +If the item is configured to have a button, +the button will now display the image or bitmap configured with the +widget options <strong>-closedbuttonimage</strong> or <strong>-closedbuttonbitmap</strong>, +or a <em>+</em> sign if no image or bitmap is configured. +If the item is already closed, this command has no effect. +<i class='arg'>ItemDesc</i> may also be the string <strong>all</strong>, +in which case all items of the treectrl widget are collapsed. +If <strong>-recurse</strong> is specified, all descendants of <i class='arg'>itemDesc</i> +will also be collapsed. +For every item, that actually will be collapsed, +two events are generated: +a <strong><Collapse-before></strong> event before the item state is changed, +and a <strong><Collapse-after></strong> event after the item state was changed. + +<br><br> +<dt><a name="48"><i class='arg'>pathName</i> <b class='cmd'>item complex</b> <i class='arg'>itemDesc</i> <i class='arg'>list</i> <i class='arg'>...</i></a><dd> Modifies the elements of the item described by <i class='arg'>itemDesc</i>. For every column of the treectrl there may be specified one <i class='arg'>list</i>, @@ -1105,7 +1099,7 @@ The corresponding <i class='arg'>value</i> will overwrite the value of the eleme one column in this item. <br><br> -<dt><a name="48"><i class='arg'>pathName</i> <b class='cmd'>item configure</b> <i class='arg'>itemDesc</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="49"><i class='arg'>pathName</i> <b class='cmd'>item configure</b> <i class='arg'>itemDesc</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> If no <i class='arg'>option</i> is specified, returns a list describing all of the available options for the item given by <i class='arg'>itemDesc</i> (see <strong>Tk_ConfigureInfo</strong> for @@ -1119,7 +1113,7 @@ and values are the same as those permissible in the <b class='cmd'>item create</ when the item was created. <br><br> -<dt><a name="49"><i class='arg'>pathName</i> <b class='cmd'>item create</b> ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="50"><i class='arg'>pathName</i> <b class='cmd'>item create</b> ?<i class='arg'>option value ...</i>?</a><dd> Creates a new item and returns its unique identifier. The new item has the states <strong>open</strong> and <strong>enabled</strong> set by default. @@ -1152,7 +1146,7 @@ and b) each ancestor's <strong>-visible</strong> option is true </dl> -<dt><a name="50"><i class='arg'>pathName</i> <b class='cmd'>item delete</b> <i class='arg'>first</i> ?<i class='arg'>last</i>?</a><dd> +<dt><a name="51"><i class='arg'>pathName</i> <b class='cmd'>item delete</b> <i class='arg'>first</i> ?<i class='arg'>last</i>?</a><dd> Deletes the specified item(s). <i class='arg'>First</i> and <i class='arg'>last</i> must be the string <strong>all</strong> or an <i class='arg'>itemDesc</i>. @@ -1170,14 +1164,14 @@ There is no way to delete the root item of the treectrl widget; in all cases the specification of the root item is ignored. <br><br> -<dt><a name="51"><i class='arg'>pathName</i> <b class='cmd'>item dump</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="52"><i class='arg'>pathName</i> <b class='cmd'>item dump</b> <i class='arg'>itemDesc</i></a><dd> Returns a list with six elements in the form <strong>index</strong> <em>index</em> <strong>indexVis</strong> <em>indexVis</em> <strong>neededHeight</strong> <em>neededHeight</em>. <br><br> -<dt><a name="52"><i class='arg'>pathName</i> <b class='cmd'>item element</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> ?<i class='arg'>arg ...</i>?</a><dd> +<dt><a name="53"><i class='arg'>pathName</i> <b class='cmd'>item element</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> ?<i class='arg'>arg ...</i>?</a><dd> This command is used to manipulate elements of the item. The exact behavior of the command depends on the <i class='arg'>command</i> argument @@ -1186,7 +1180,7 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="53"><i class='arg'>pathName</i> <b class='cmd'>item element actual</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> <i class='arg'>option</i></a><dd> +<dt><a name="54"><i class='arg'>pathName</i> <b class='cmd'>item element actual</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> <i class='arg'>option</i></a><dd> This command returns the current value of the configuration option named <i class='arg'>option</i> associated with <i class='arg'>element</i> inside <i class='arg'>column</i> of the item described by @@ -1198,7 +1192,7 @@ was used. Otherwise the value of the configuration option of the underlying elem specified element (see <a href="#elements">ELEMENTS</a> below) <br><br> -<dt><a name="54"><i class='arg'>pathName</i> <b class='cmd'>item element cget</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> <i class='arg'>option</i></a><dd> +<dt><a name="55"><i class='arg'>pathName</i> <b class='cmd'>item element cget</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> <i class='arg'>option</i></a><dd> This command returns the value of the option named <i class='arg'>option</i> associated with <i class='arg'>element</i> inside <i class='arg'>column</i> of the item described by @@ -1207,7 +1201,7 @@ associated with <i class='arg'>element</i> inside <i class='arg'>column</i> of t specified element (see <a href="#elements">ELEMENTS</a> below) <br><br> -<dt><a name="55"><i class='arg'>pathName</i> <b class='cmd'>item element configure</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="56"><i class='arg'>pathName</i> <b class='cmd'>item element configure</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>element</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> This command is similar to the <b class='cmd'>configure</b> widget command except that it modifies options associated with @@ -1226,7 +1220,26 @@ modifies the given option(s) to have the given value(s) in the in this case the command returns an empty string. </dl> -<dt><a name="56"><i class='arg'>pathName</i> <b class='cmd'>item firstchild</b> <i class='arg'>parent</i> ?<i class='arg'>child</i>?</a><dd> +<dt><a name="57"><i class='arg'>pathName</i> <b class='cmd'>item expand</b> <i class='arg'>itemDesc</i> ?<strong>-recurse</strong>?</a><dd> + +Switches on the <strong>open</strong> state of the item(s) described by <i class='arg'>itemDesc</i>. +If the item has descendants, they are now displayed. +If the item is configured to have a button, +the button will now display the image or bitmap configured with the +widget options <strong>-openbuttonimage</strong> or <strong>-openbuttonbitmap</strong>, +or a <em>-</em> sign if no image or bitmap is configured. +If the item is already open, this command has no effect. +<i class='arg'>ItemDesc</i> may also be the string <strong>all</strong>, +in which case all items of the treectrl widget are expanded. +If <strong>-recurse</strong> is specified, all descendants of <i class='arg'>itemDesc</i> +will also be expanded. +For every item, that actually will be expanded, +two events are generated: +an <strong><Expand-before></strong> event before the item state is changed, +and an <strong><Expand-after></strong> event after the item state was changed. + +<br><br> +<dt><a name="58"><i class='arg'>pathName</i> <b class='cmd'>item firstchild</b> <i class='arg'>parent</i> ?<i class='arg'>child</i>?</a><dd> If <i class='arg'>child</i> is not specified, returns the numerical index of the first child of the item described by <i class='arg'>parent</i>. @@ -1235,7 +1248,7 @@ that is not an ancestor of <i class='arg'>parent</i>. Then it will become the new first child of <i class='arg'>parent</i>. <br><br> -<dt><a name="57"><i class='arg'>pathName</i> <b class='cmd'>item index</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="59"><i class='arg'>pathName</i> <b class='cmd'>item index</b> <i class='arg'>itemDesc</i></a><dd> Returns a list of two integers, which corresponds to the row of the item described by <i class='arg'>itemDesc</i>, @@ -1245,19 +1258,19 @@ which return the invariable item id. The index here is basically the row of the item. <br><br> -<dt><a name="58"><i class='arg'>pathName</i> <b class='cmd'>item isancestor</b> <i class='arg'>itemDesc</i> <i class='arg'>descendant</i></a><dd> +<dt><a name="60"><i class='arg'>pathName</i> <b class='cmd'>item isancestor</b> <i class='arg'>itemDesc</i> <i class='arg'>descendant</i></a><dd> Returns 1 if the item described by <i class='arg'>itemDesc</i> is a direct or indirect parent of the item decribed by <i class='arg'>descendant</i>, 0 otherwise. <br><br> -<dt><a name="59"><i class='arg'>pathName</i> <b class='cmd'>item isopen</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="61"><i class='arg'>pathName</i> <b class='cmd'>item isopen</b> <i class='arg'>itemDesc</i></a><dd> Returns 1, if the item described by <i class='arg'>itemDesc</i> has cuurently the state <strong>open</strong> switched on, 0 otherwise. <br><br> -<dt><a name="60"><i class='arg'>pathName</i> <b class='cmd'>item lastchild</b> <i class='arg'>parent</i> ?<i class='arg'>child</i>?</a><dd> +<dt><a name="62"><i class='arg'>pathName</i> <b class='cmd'>item lastchild</b> <i class='arg'>parent</i> ?<i class='arg'>child</i>?</a><dd> If <i class='arg'>child</i> is not specified, returns the numerical index of the last child of the item described by <i class='arg'>parent</i>. @@ -1266,7 +1279,7 @@ that is not an ancestor of <i class='arg'>parent</i>. Then it will become the new last child of <i class='arg'>parent</i>. <br><br> -<dt><a name="61"><i class='arg'>pathName</i> <b class='cmd'>item nextsibling</b> <i class='arg'>sibling</i> ?<i class='arg'>next</i>?</a><dd> +<dt><a name="63"><i class='arg'>pathName</i> <b class='cmd'>item nextsibling</b> <i class='arg'>sibling</i> ?<i class='arg'>next</i>?</a><dd> If <i class='arg'>next</i> is not specified, returns the numerical index of the next sibling of the item described by <i class='arg'>sibling</i>. @@ -1275,18 +1288,18 @@ that is not an ancestor of <i class='arg'>sibling</i>. Then it will become the new next sibling of <i class='arg'>sibling</i>. <br><br> -<dt><a name="62"><i class='arg'>pathName</i> <b class='cmd'>item numchildren</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="64"><i class='arg'>pathName</i> <b class='cmd'>item numchildren</b> <i class='arg'>itemDesc</i></a><dd> Returns the number of children of the item described by <i class='arg'>itemDesc</i>. <br><br> -<dt><a name="63"><i class='arg'>pathName</i> <b class='cmd'>item parent</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="65"><i class='arg'>pathName</i> <b class='cmd'>item parent</b> <i class='arg'>itemDesc</i></a><dd> Returns the numerical index of the parent of the item described by <i class='arg'>itemDesc</i>. <br><br> -<dt><a name="64"><i class='arg'>pathName</i> <b class='cmd'>item prevsibling</b> <i class='arg'>sibling</i> ?<i class='arg'>prev</i>?</a><dd> +<dt><a name="66"><i class='arg'>pathName</i> <b class='cmd'>item prevsibling</b> <i class='arg'>sibling</i> ?<i class='arg'>prev</i>?</a><dd> If <i class='arg'>prev</i> is not specified, returns the numerical index of the previous sibling of the item described by <i class='arg'>sibling</i>. @@ -1295,19 +1308,19 @@ that is not an ancestor of <i class='arg'>sibling</i>. Then it will become the new previous sibling of <i class='arg'>sibling</i>. <br><br> -<dt><a name="65"><i class='arg'>pathName</i> <b class='cmd'>item remove</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="67"><i class='arg'>pathName</i> <b class='cmd'>item remove</b> <i class='arg'>itemDesc</i></a><dd> Removes the item described by <i class='arg'>itemDesc</i> from the children list of its father, so that it will become an orphan. <br><br> -<dt><a name="66"><i class='arg'>pathName</i> <b class='cmd'>item rnc</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="68"><i class='arg'>pathName</i> <b class='cmd'>item rnc</b> <i class='arg'>itemDesc</i></a><dd> Returns a list of two integers, which corresponds to the row and column of the item described by <i class='arg'>itemDesc</i>. <br><br> -<dt><a name="67"><i class='arg'>pathName</i> <b class='cmd'>item sort</b> <i class='arg'>itemDesc</i> ?<i class='arg'>option ...</i>?</a><dd> +<dt><a name="69"><i class='arg'>pathName</i> <b class='cmd'>item sort</b> <i class='arg'>itemDesc</i> ?<i class='arg'>option ...</i>?</a><dd> Sorts the children of the item described by <i class='arg'>itemDesc</i>, and redisplays the tree with the items in the new order. @@ -1378,7 +1391,7 @@ Convert to integers and use integer comparison. Convert to floating-point values and use floating comparison. </dl> -<dt><a name="68"><i class='arg'>pathName</i> <b class='cmd'>item state</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> ?<i class='arg'>arg ...</i>?</a><dd> +<dt><a name="70"><i class='arg'>pathName</i> <b class='cmd'>item state</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> ?<i class='arg'>arg ...</i>?</a><dd> This command is used to manipulate the states of an item. The exact behavior of the command depends on the <i class='arg'>command</i> argument @@ -1388,13 +1401,13 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="69"><i class='arg'>pathName</i> <b class='cmd'>item state forcolumn</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> ?<i class='arg'>stateDescList</i>?</a><dd> +<dt><a name="71"><i class='arg'>pathName</i> <b class='cmd'>item state forcolumn</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> ?<i class='arg'>stateDescList</i>?</a><dd> Just like <b class='cmd'>item state set</b> but manipulates user-defined states for a single item column, not the item as a whole. <br><br> -<dt><a name="70"><i class='arg'>pathName</i> <b class='cmd'>item state get</b> <i class='arg'>itemDesc</i> ?<i class='arg'>stateName ...</i>?</a><dd> +<dt><a name="72"><i class='arg'>pathName</i> <b class='cmd'>item state get</b> <i class='arg'>itemDesc</i> ?<i class='arg'>stateName ...</i>?</a><dd> If no <i class='arg'>stateName</i> is specified, returns a list containing the names of all (predefined and user defined) states @@ -1404,7 +1417,7 @@ If a <i class='arg'>stateName</i> is specified, 0 otherwise. <br><br> -<dt><a name="71"><i class='arg'>pathName</i> <b class='cmd'>item state set</b> <i class='arg'>itemDesc</i> ?<i class='arg'>lastItem</i>? ?<i class='arg'>stateDescList</i>?</a><dd> +<dt><a name="73"><i class='arg'>pathName</i> <b class='cmd'>item state set</b> <i class='arg'>itemDesc</i> ?<i class='arg'>lastItem</i>? ?<i class='arg'>stateDescList</i>?</a><dd> Every element of <i class='arg'>stateDescList</i> must describe a user defined state (see <a href="#states">STATES</a> below), @@ -1420,7 +1433,7 @@ then the state changes are made for all items of the treectrl widget. </dl> -<dt><a name="72"><i class='arg'>pathName</i> <b class='cmd'>item style</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> ?<i class='arg'>arg ...</i>?</a><dd> +<dt><a name="74"><i class='arg'>pathName</i> <b class='cmd'>item style</b> <i class='arg'>command</i> <i class='arg'>itemDesc</i> ?<i class='arg'>arg ...</i>?</a><dd> This command is used to manipulate the styles of an item. The exact behavior of the command depends on the <i class='arg'>command</i> argument @@ -1429,14 +1442,14 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="73"><i class='arg'>pathName</i> <b class='cmd'>item style elements</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i></a><dd> +<dt><a name="75"><i class='arg'>pathName</i> <b class='cmd'>item style elements</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i></a><dd> A list is returned containing the currently defined elements of the style, which is set for the item described by <i class='arg'>itemDesc</i> in <i class='arg'>column</i>. <br><br> -<dt><a name="74"><i class='arg'>pathName</i> <b class='cmd'>item style map</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>style</i> <i class='arg'>map</i></a><dd> +<dt><a name="76"><i class='arg'>pathName</i> <b class='cmd'>item style map</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> <i class='arg'>style</i> <i class='arg'>map</i></a><dd> Like the <b class='cmd'>item style set</b> command, this command may be used to assign a style to a specific column of an item. Unlike <b class='cmd'>item style set</b>, this @@ -1449,7 +1462,7 @@ an element in the style specified by <i class='arg'>style</i>. Both <i class='ar <i class='arg'>elementNew</i> must be of the same type (<strong>bitmap</strong>, <strong>text</strong> etc). <br><br> -<dt><a name="75"><i class='arg'>pathName</i> <b class='cmd'>item style set</b> <i class='arg'>itemDesc</i> ?<i class='arg'>column</i>? ?<i class='arg'>style</i>? ?<i class='arg'>column style ...</i>?</a><dd> +<dt><a name="77"><i class='arg'>pathName</i> <b class='cmd'>item style set</b> <i class='arg'>itemDesc</i> ?<i class='arg'>column</i>? ?<i class='arg'>style</i>? ?<i class='arg'>column style ...</i>?</a><dd> If no <i class='arg'>column</i> is specified, returns a list containing the names of the styles set for all columns of the item described by <i class='arg'>itemDesc</i>. @@ -1461,7 +1474,7 @@ it must be <i class='arg'>column</i>-<i class='arg'>style</i> pairs; then the style(s) of item in <i class='arg'>column</i> will be set to <i class='arg'>style</i>. </dl> -<dt><a name="76"><i class='arg'>pathName</i> <b class='cmd'>item text</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> ?<i class='arg'>text</i>? ?<i class='arg'>column text ...</i>?</a><dd> +<dt><a name="78"><i class='arg'>pathName</i> <b class='cmd'>item text</b> <i class='arg'>itemDesc</i> <i class='arg'>column</i> ?<i class='arg'>text</i>? ?<i class='arg'>column text ...</i>?</a><dd> If no <i class='arg'>text</i> argument is specified, returns the text of the first text element in <i class='arg'>column</i> for the item @@ -1473,9 +1486,21 @@ this command is provided as a convenience. Use the <b class='cmd'>item element configure</b> command if you want to set the text of a specific text element. +<br><br> +<dt><a name="79"><i class='arg'>pathName</i> <b class='cmd'>item toggle</b> <i class='arg'>itemDesc</i> ?<strong>-recurse</strong>?</a><dd> + +Changes the <strong>open</strong> state of the item(s) described by <i class='arg'>itemDesc</i>. +If the state is currently switched off, +this command does the same as the <b class='cmd'>item expand</b> widget command, +otherwise the same as the <b class='cmd'>item collapse</b> widget command. +<i class='arg'>ItemDesc</i> may also be the string <strong>all</strong>, +in which case the state of all items of the treectrl widget are toggled. +If <strong>-recurse</strong> is specified, the state of all descendants of +<i class='arg'>itemDesc</i> will also be toggled. + </dl> -<dt><a name="77"><i class='arg'>pathName</i> <b class='cmd'>marquee</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a><dd> +<dt><a name="80"><i class='arg'>pathName</i> <b class='cmd'>marquee</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a><dd> This command is used to manipulate the marquee, a rectangular region of the treectrl widget @@ -1492,7 +1517,7 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="78"><i class='arg'>pathName</i> <b class='cmd'>marquee anchor</b> ?<i class='arg'>x y</i>?</a><dd> +<dt><a name="81"><i class='arg'>pathName</i> <b class='cmd'>marquee anchor</b> ?<i class='arg'>x y</i>?</a><dd> Returns a list containing the x and y coordinates of the anchor, if no additional arguments are specified. @@ -1500,7 +1525,7 @@ If two coordinates are specified, sets the anchor to the given coordinates <i class='arg'>x</i> and <i class='arg'>y</i>. <br><br> -<dt><a name="79"><i class='arg'>pathName</i> <b class='cmd'>marquee cget</b> <i class='arg'>option</i></a><dd> +<dt><a name="82"><i class='arg'>pathName</i> <b class='cmd'>marquee cget</b> <i class='arg'>option</i></a><dd> This command returns the current value of the marquee option named <i class='arg'>option</i>. @@ -1508,7 +1533,7 @@ named <i class='arg'>option</i>. <b class='cmd'>marquee configure</b> widget command. <br><br> -<dt><a name="80"><i class='arg'>pathName</i> <b class='cmd'>marquee configure</b> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="83"><i class='arg'>pathName</i> <b class='cmd'>marquee configure</b> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> This command is similar to the <b class='cmd'>configure</b> widget command except that it modifies the marquee options @@ -1535,7 +1560,7 @@ whether the dotted line surrounding the region of the marquee should currently be visible. </dl> -<dt><a name="81"><i class='arg'>pathName</i> <b class='cmd'>marquee coords</b> ?<i class='arg'>x1 y1 x2 y2</i>?</a><dd> +<dt><a name="84"><i class='arg'>pathName</i> <b class='cmd'>marquee coords</b> ?<i class='arg'>x1 y1 x2 y2</i>?</a><dd> Returns a list containing the x and y coordinates of the anchor followed by the x and y coordinates of the corner, @@ -1545,7 +1570,7 @@ sets the anchor to the given coordinates <i class='arg'>x1</i> and <i class='arg and the corner to the coordinates <i class='arg'>x2</i> and <i class='arg'>y2</i>. <br><br> -<dt><a name="82"><i class='arg'>pathName</i> <b class='cmd'>marquee corner</b> ?<i class='arg'>x y</i>?</a><dd> +<dt><a name="85"><i class='arg'>pathName</i> <b class='cmd'>marquee corner</b> ?<i class='arg'>x y</i>?</a><dd> Returns a list containing the x and y coordinates of the corner, if no additional arguments are specified. @@ -1553,7 +1578,7 @@ If two coordinates are specified, sets the corner to the given coordinates <i class='arg'>x</i> and <i class='arg'>y</i>. <br><br> -<dt><a name="83"><i class='arg'>pathName</i> <b class='cmd'>marquee identify</b></a><dd> +<dt><a name="86"><i class='arg'>pathName</i> <b class='cmd'>marquee identify</b></a><dd> Returns a list with information about the items inside the marquee. The list has as elements a list itself @@ -1567,7 +1592,7 @@ if there are any. </dl> -<dt><a name="84"><i class='arg'>pathName</i> <b class='cmd'>notify</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a><dd> +<dt><a name="87"><i class='arg'>pathName</i> <b class='cmd'>notify</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a><dd> This command is used to manipulate the event mechanism of a treectrl widget, which stands in parallel to Tk's event mechanism. @@ -1584,7 +1609,7 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="85"><i class='arg'>pathName</i> <b class='cmd'>notify bind</b> ?<i class='arg'>object</i>? ?<i class='arg'>pattern</i>? ?<i class='arg'>script</i>?</a><dd> +<dt><a name="88"><i class='arg'>pathName</i> <b class='cmd'>notify bind</b> ?<i class='arg'>object</i>? ?<i class='arg'>pattern</i>? ?<i class='arg'>script</i>?</a><dd> This command associates <i class='arg'>script</i> with the object given by <i class='arg'>object</i> such that whenever the event sequence given by @@ -1608,7 +1633,7 @@ If no optional argument is specified, a list of all <i class='arg'>object</i>s to which a pattern-script combination is bound yet, is returned. <br><br> -<dt><a name="86"><i class='arg'>pathName</i> <b class='cmd'>notify configure</b> <i class='arg'>window</i> <i class='arg'>pattern</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="89"><i class='arg'>pathName</i> <b class='cmd'>notify configure</b> <i class='arg'>window</i> <i class='arg'>pattern</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> This command is similar to the <b class='cmd'>configure</b> widget command except that it modifies event options defined for <i class='arg'>pattern</i> in <i class='arg'>window</i> @@ -1632,7 +1657,7 @@ As long as this option is specified as false, the event will not trigger. </dl> -<dt><a name="87"><i class='arg'>pathName</i> <b class='cmd'>notify detailnames</b> <i class='arg'>eventName</i></a><dd> +<dt><a name="90"><i class='arg'>pathName</i> <b class='cmd'>notify detailnames</b> <i class='arg'>eventName</i></a><dd> Returns a list containing the names of all details, which are installed for the event with the name <i class='arg'>eventName</i> @@ -1640,14 +1665,14 @@ by means of the <b class='cmd'>notify install detail</b> widget command or by the treectrl widget itself. <br><br> -<dt><a name="88"><i class='arg'>pathName</i> <b class='cmd'>notify eventnames</b></a><dd> +<dt><a name="91"><i class='arg'>pathName</i> <b class='cmd'>notify eventnames</b></a><dd> Returns a list containing the names of all events, which are installed by means of the <b class='cmd'>notify install event</b> widget command or by the treectrl widget itself. <br><br> -<dt><a name="89"><i class='arg'>pathName</i> <b class='cmd'>notify generate</b> <i class='arg'>pattern</i> ?<i class='arg'>charMap</i>?</a><dd> +<dt><a name="92"><i class='arg'>pathName</i> <b class='cmd'>notify generate</b> <i class='arg'>pattern</i> ?<i class='arg'>charMap</i>?</a><dd> The event with the pattern <i class='arg'>pattern</i> is generated, if it is configured as active. @@ -1667,7 +1692,7 @@ every occurence of a percent character (<strong>%</strong>) followed by a <i cla will be replaced with its corresponding <i class='arg'>value</i>. <br><br> -<dt><a name="90"><i class='arg'>pathName</i> <b class='cmd'>notify install detail</b> <i class='arg'>eventName</i> <i class='arg'>detail</i> ?<i class='arg'>percentsCommand</i>?</a><dd> +<dt><a name="93"><i class='arg'>pathName</i> <b class='cmd'>notify install detail</b> <i class='arg'>eventName</i> <i class='arg'>detail</i> ?<i class='arg'>percentsCommand</i>?</a><dd> Installs a new detail <i class='arg'>detail</i> for the event with the name <i class='arg'>eventName</i>. @@ -1691,7 +1716,7 @@ the returning string, or by an empty string if the command returns with a returnCode other than 0. <br><br> -<dt><a name="91"><i class='arg'>pathName</i> <b class='cmd'>notify install event</b> <i class='arg'>eventName</i> ?<i class='arg'>percentsCommand</i>?</a><dd> +<dt><a name="94"><i class='arg'>pathName</i> <b class='cmd'>notify install event</b> <i class='arg'>eventName</i> ?<i class='arg'>percentsCommand</i>?</a><dd> Installs a new event with the name <i class='arg'>eventName</i>. An event create by this command is called dynamic, @@ -1701,7 +1726,7 @@ see the description of the <b class='cmd'>notify install detail</b> widget comma the value for the argument <i class='arg'>detail</i> is the empty string. <br><br> -<dt><a name="92"><i class='arg'>pathName</i> <b class='cmd'>notify linkage</b> <i class='arg'>eventName</i> ?<i class='arg'>detail</i>?</a><dd> +<dt><a name="95"><i class='arg'>pathName</i> <b class='cmd'>notify linkage</b> <i class='arg'>eventName</i> ?<i class='arg'>detail</i>?</a><dd> Returns a string indicating whether the specified event or detail is created @@ -1709,7 +1734,7 @@ by means of the <b class='cmd'>notify install</b> widget command (<strong>dynami or by the treectrl widget itself (<strong>static</strong>). <br><br> -<dt><a name="93"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall detail</b> <i class='arg'>eventName</i> <i class='arg'>detail</i></a><dd> +<dt><a name="96"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall detail</b> <i class='arg'>eventName</i> <i class='arg'>detail</i></a><dd> If the specified detail <i class='arg'>detail</i> of the event with the name <i class='arg'>eventName</i> is static @@ -1717,14 +1742,14 @@ of the event with the name <i class='arg'>eventName</i> is static Otherwise the dynamic detail is removed from the event. <br><br> -<dt><a name="94"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall event</b> <i class='arg'>eventName</i></a><dd> +<dt><a name="97"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall event</b> <i class='arg'>eventName</i></a><dd> If the specified event with the name <i class='arg'>eventName</i> is static (i.e. created by the treectrl widget itself), an error is generated. Otherwise the dynamic event is removed. </dl> -<dt><a name="95"><i class='arg'>pathName</i> <b class='cmd'>numcolumns</b></a><dd> +<dt><a name="98"><i class='arg'>pathName</i> <b class='cmd'>numcolumns</b></a><dd> Returns a decimal string giving the number of columns created by the <b class='cmd'>column create</b> widget command which haven't been @@ -1732,7 +1757,7 @@ deleted by the <b class='cmd'>column delete</b> widget command. The <strong>tail is not counted. <br><br> -<dt><a name="96"><i class='arg'>pathName</i> <b class='cmd'>numitems</b></a><dd> +<dt><a name="99"><i class='arg'>pathName</i> <b class='cmd'>numitems</b></a><dd> Returns a decimal string giving the number of items created by the <b class='cmd'>item create</b> widget command which haven't been @@ -1742,7 +1767,7 @@ since a newly created treectrl widget has already the root item, which cannot be deleted. <br><br> -<dt><a name="97"><i class='arg'>pathName</i> <b class='cmd'>orphans</b></a><dd> +<dt><a name="100"><i class='arg'>pathName</i> <b class='cmd'>orphans</b></a><dd> Returns a list containing the numerical ids of all items which has no parent item. @@ -1751,7 +1776,7 @@ and can later become an orphan again by means of the <b class='cmd'>item remove</b> widget command. <br><br> -<dt><a name="98"><i class='arg'>pathName</i> <b class='cmd'>range</b> <i class='arg'>first</i> <i class='arg'>last</i></a><dd> +<dt><a name="101"><i class='arg'>pathName</i> <b class='cmd'>range</b> <i class='arg'>first</i> <i class='arg'>last</i></a><dd> <i class='arg'>First</i> and <i class='arg'>last</i> must be an <i class='arg'>itemDesc</i>. Returns a list containing the numerical ids of all items @@ -1760,7 +1785,7 @@ The order between <i class='arg'>first</i> and <i class='arg'>last</i> doesn't m and the result is always ordered by the increasing index of the items. <br><br> -<dt><a name="99"><i class='arg'>pathName</i> <b class='cmd'>state</b> <i class='arg'>option</i> ?<i class='arg'>stateName</i>?</a><dd> +<dt><a name="102"><i class='arg'>pathName</i> <b class='cmd'>state</b> <i class='arg'>option</i> ?<i class='arg'>stateName</i>?</a><dd> This command is used to manipulate the list of user defined states, see section <a href="#states">STATES</a> below. @@ -1770,13 +1795,13 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="100"><i class='arg'>pathName</i> <b class='cmd'>state define</b> <i class='arg'>stateName</i></a><dd> +<dt><a name="103"><i class='arg'>pathName</i> <b class='cmd'>state define</b> <i class='arg'>stateName</i></a><dd> Defines a new state with the name <i class='arg'>stateName</i>, which must not be the name of a predefined or already user defined state. <br><br> -<dt><a name="101"><i class='arg'>pathName</i> <b class='cmd'>state linkage</b> <i class='arg'>stateName</i></a><dd> +<dt><a name="104"><i class='arg'>pathName</i> <b class='cmd'>state linkage</b> <i class='arg'>stateName</i></a><dd> Returns a string indicating whether the specified state is user defined @@ -1784,18 +1809,18 @@ by means of the <b class='cmd'>state define</b> widget command (<strong>dynamic< or predefined by the treectrl widget itself (<strong>static</strong>). <br><br> -<dt><a name="102"><i class='arg'>pathName</i> <b class='cmd'>state names</b></a><dd> +<dt><a name="105"><i class='arg'>pathName</i> <b class='cmd'>state names</b></a><dd> Returns a list containing the names of all user defined states. <br><br> -<dt><a name="103"><i class='arg'>pathName</i> <b class='cmd'>state undefine</b> ?<i class='arg'>stateName ...</i>?</a><dd> +<dt><a name="106"><i class='arg'>pathName</i> <b class='cmd'>state undefine</b> ?<i class='arg'>stateName ...</i>?</a><dd> Every <i class='arg'>stateName</i> must be the name of a user defined state. Removes this state from the list of user defined states. </dl> -<dt><a name="104"><i class='arg'>pathName</i> <b class='cmd'>see</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="107"><i class='arg'>pathName</i> <b class='cmd'>see</b> <i class='arg'>itemDesc</i></a><dd> Adjust the view in the treectrl so that the item described by <i class='arg'>itemDesc</i> is visible. @@ -1805,14 +1830,14 @@ and the corresponding <strong><Scroll-x></strong> and/or <strong><Scrol events are generated. <br><br> -<dt><a name="105"><i class='arg'>pathName</i> <b class='cmd'>selection</b> <i class='arg'>option</i> <i class='arg'>arg</i></a><dd> +<dt><a name="108"><i class='arg'>pathName</i> <b class='cmd'>selection</b> <i class='arg'>option</i> <i class='arg'>arg</i></a><dd> This command is used to adjust the selection within a treectrl. It has several forms, depending on <i class='arg'>option</i>: <br><br> <dl> -<dt><a name="106"><i class='arg'>pathName</i> <b class='cmd'>selection add</b> <i class='arg'>first</i> ?<i class='arg'>last</i>?</a><dd> +<dt><a name="109"><i class='arg'>pathName</i> <b class='cmd'>selection add</b> <i class='arg'>first</i> ?<i class='arg'>last</i>?</a><dd> <i class='arg'>First</i> and <i class='arg'>last</i> (if specified) must be the string <strong>all</strong> or an <i class='arg'>itemDesc</i>. @@ -1824,7 +1849,7 @@ all items of the treectrl widget are added to the selection instead. A <strong><Selection></strong> event is generated. <br><br> -<dt><a name="107"><i class='arg'>pathName</i> <b class='cmd'>selection anchor</b> ?<i class='arg'>itemDesc</i>?</a><dd> +<dt><a name="110"><i class='arg'>pathName</i> <b class='cmd'>selection anchor</b> ?<i class='arg'>itemDesc</i>?</a><dd> If <i class='arg'>itemDesc</i> is specified, the selection anchor is set to the described item. @@ -1835,7 +1860,7 @@ This command doesn't modify the selection state of any item. Returns the numerical id of the selection anchor item. <br><br> -<dt><a name="108"><i class='arg'>pathName</i> <b class='cmd'>selection clear</b> ?<i class='arg'>first</i>? ?<i class='arg'>last</i>?</a><dd> +<dt><a name="111"><i class='arg'>pathName</i> <b class='cmd'>selection clear</b> ?<i class='arg'>first</i>? ?<i class='arg'>last</i>?</a><dd> <i class='arg'>First</i> and <i class='arg'>last</i> (if specified) must be the string <strong>all</strong> or an <i class='arg'>itemDesc</i>. @@ -1848,13 +1873,13 @@ the selection is completely cleared instead. A <strong><Selection></strong> event is generated. <br><br> -<dt><a name="109"><i class='arg'>pathName</i> <b class='cmd'>selection count</b></a><dd> +<dt><a name="112"><i class='arg'>pathName</i> <b class='cmd'>selection count</b></a><dd> Returns an integer indicating the number of items in the treectrl that are currently selected. <br><br> -<dt><a name="110"><i class='arg'>pathName</i> <b class='cmd'>selection get</b></a><dd> +<dt><a name="113"><i class='arg'>pathName</i> <b class='cmd'>selection get</b></a><dd> Returns a list containing the numerical ids of all of the items in the treectrl that are currently selected. @@ -1862,13 +1887,13 @@ If there are no items selected in the treectrl then an empty string is returned. <br><br> -<dt><a name="111"><i class='arg'>pathName</i> <b class='cmd'>selection includes</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="114"><i class='arg'>pathName</i> <b class='cmd'>selection includes</b> <i class='arg'>itemDesc</i></a><dd> Returns 1 if the item indicated by <i class='arg'>itemDesc</i> is currently selected, 0 if it isn't. <br><br> -<dt><a name="112"><i class='arg'>pathName</i> <b class='cmd'>selection modify</b> <i class='arg'>select</i> <i class='arg'>deselect</i></a><dd> +<dt><a name="115"><i class='arg'>pathName</i> <b class='cmd'>selection modify</b> <i class='arg'>select</i> <i class='arg'>deselect</i></a><dd> Both arguments <i class='arg'>select</i> and <i class='arg'>deselect</i> must be the string <strong>all</strong> or a possibly empty list of <i class='arg'>itemDesc</i>s. @@ -1881,7 +1906,7 @@ it is added to the selection. A <strong><Selection></strong> event is generated. </dl> -<dt><a name="113"><i class='arg'>pathName</i> <b class='cmd'>style</b> <i class='arg'>option</i> ?<i class='arg'>element</i>? ?<i class='arg'>arg arg ...</i>?</a><dd> +<dt><a name="116"><i class='arg'>pathName</i> <b class='cmd'>style</b> <i class='arg'>option</i> ?<i class='arg'>element</i>? ?<i class='arg'>arg arg ...</i>?</a><dd> This command is used to manipulate styles, which could be considered as a geometry manager for the elements of one item. @@ -1891,7 +1916,7 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="114"><i class='arg'>pathName</i> <b class='cmd'>style cget</b> <i class='arg'>style</i> <i class='arg'>option</i></a><dd> +<dt><a name="117"><i class='arg'>pathName</i> <b class='cmd'>style cget</b> <i class='arg'>style</i> <i class='arg'>option</i></a><dd> This command returns the current value of the option named <i class='arg'>option</i> associated with the style given by <i class='arg'>style</i>. @@ -1899,7 +1924,7 @@ associated with the style given by <i class='arg'>style</i>. <b class='cmd'>style configure</b> widget command. <br><br> -<dt><a name="115"><i class='arg'>pathName</i> <b class='cmd'>style configure</b> <i class='arg'>style</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="118"><i class='arg'>pathName</i> <b class='cmd'>style configure</b> <i class='arg'>style</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> This command is similar to the <b class='cmd'>configure</b> widget command except that it modifies options associated with the style given by <i class='arg'>style</i> @@ -1928,7 +1953,7 @@ Must be either <strong>horizontal</strong> (the default) or <strong>vertical</strong> or an abbreviation of one of these. </dl> -<dt><a name="116"><i class='arg'>pathName</i> <b class='cmd'>style create</b> <i class='arg'>style</i> ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="119"><i class='arg'>pathName</i> <b class='cmd'>style create</b> <i class='arg'>style</i> ?<i class='arg'>option value ...</i>?</a><dd> Create a new style in <i class='arg'>pathName</i> with name <i class='arg'>style</i>. After <i class='arg'>style</i> there may be any number of <i class='arg'>option</i>-<i class='arg'>value</i> @@ -1939,7 +1964,7 @@ configuration. Returns the name of the new style. <br><br> -<dt><a name="117"><i class='arg'>pathName</i> <b class='cmd'>style delete</b> ?<i class='arg'>style ...</i>?</a><dd> +<dt><a name="120"><i class='arg'>pathName</i> <b class='cmd'>style delete</b> ?<i class='arg'>style ...</i>?</a><dd> Deletes each of the named styles and returns an empty string. If a style is deleted while it is still used to display @@ -1947,7 +1972,7 @@ one or more items, it is also removed from the style list of these items. <br><br> -<dt><a name="118"><i class='arg'>pathName</i> <b class='cmd'>style elements</b> <i class='arg'>style</i> ?<i class='arg'>elementList</i>?</a><dd> +<dt><a name="121"><i class='arg'>pathName</i> <b class='cmd'>style elements</b> <i class='arg'>style</i> ?<i class='arg'>elementList</i>?</a><dd> Specifies the elements which should be layed out by this style. Each element of <i class='arg'>elementList</i> must be the name of an element @@ -1962,7 +1987,7 @@ If the <i class='arg'>elementList</i> argument is not specified, a list is retur containing the currently defined elements of <i class='arg'>style</i>. <br><br> -<dt><a name="119"><i class='arg'>pathName</i> <b class='cmd'>style layout</b> <i class='arg'>style</i> <i class='arg'>element</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="122"><i class='arg'>pathName</i> <b class='cmd'>style layout</b> <i class='arg'>style</i> <i class='arg'>element</i> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> This command is similar to the <b class='cmd'>configure</b> widget command except that it modifies options used by <i class='arg'>style</i> for laying out <i class='arg'>element</i> @@ -2032,24 +2057,17 @@ Specifies whether the element should be positioned by themselves, i.e. independent from the other elements. </dl> -<dt><a name="120"><i class='arg'>pathName</i> <b class='cmd'>style names</b></a><dd> +<dt><a name="123"><i class='arg'>pathName</i> <b class='cmd'>style names</b></a><dd> Returns a list containing the names of all existing styles. </dl> -<dt><a name="121"><i class='arg'>pathName</i> <b class='cmd'>toggle</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a><dd> +<dt><a name="124"><i class='arg'>pathName</i> <b class='cmd'>toggle</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a><dd> -Changes the <strong>open</strong> state of the item(s) described by <i class='arg'>itemDesc</i>. -If the state is currently switched off, -this command does the same as the <b class='cmd'>expand</b> widget command, -otherwise the same as the <b class='cmd'>collapse</b> widget command. -<i class='arg'>ItemDesc</i> may also be the string <strong>all</strong>, -in which case the state of all items of the treectrl widget are toggled. -If <strong>-recurse</strong> is specified, the state of all descendants of -<i class='arg'>itemDesc</i> will also be toggles. +Use <b class='cmd'>item toggle</b> instead. <br><br> -<dt><a name="122"><i class='arg'>pathName</i> <b class='cmd'>xview</b> ?<i class='arg'>args</i>?</a><dd> +<dt><a name="125"><i class='arg'>pathName</i> <b class='cmd'>xview</b> ?<i class='arg'>args</i>?</a><dd> This command is used to query and change the horizontal position of the information displayed in the treectrl's window. @@ -2057,7 +2075,7 @@ It can take any of the following forms: <br><br> <dl> -<dt><a name="123"><i class='arg'>pathName</i> <b class='cmd'>xview</b></a><dd> +<dt><a name="126"><i class='arg'>pathName</i> <b class='cmd'>xview</b></a><dd> Returns a list containing two elements. Each element is a real fraction between 0 and 1; together they describe @@ -2070,7 +2088,7 @@ These are the same values passed to scrollbars via the <strong>-xscrollcommand</ option. <br><br> -<dt><a name="124"><i class='arg'>pathName</i> <b class='cmd'>xview moveto</b> <i class='arg'>fraction</i></a><dd> +<dt><a name="127"><i class='arg'>pathName</i> <b class='cmd'>xview moveto</b> <i class='arg'>fraction</i></a><dd> Adjusts the view in the window so that <i class='arg'>fraction</i> of the total width of the tree is off-screen to the left. @@ -2078,7 +2096,7 @@ total width of the tree is off-screen to the left. A <strong><Scroll-x></strong> event is generated. <br><br> -<dt><a name="125"><i class='arg'>pathName</i> <b class='cmd'>xview scroll</b> <i class='arg'>number</i> <i class='arg'>what</i></a><dd> +<dt><a name="128"><i class='arg'>pathName</i> <b class='cmd'>xview scroll</b> <i class='arg'>number</i> <i class='arg'>what</i></a><dd> This command shifts the view in the window left or right according to <i class='arg'>number</i> and <i class='arg'>what</i>. @@ -2096,7 +2114,7 @@ becomes visible. A <strong><Scroll-x></strong> event is generated. </dl> -<dt><a name="126"><i class='arg'>pathName</i> <b class='cmd'>yview</b> ?<i class='arg'>args</i>?</a><dd> +<dt><a name="129"><i class='arg'>pathName</i> <b class='cmd'>yview</b> ?<i class='arg'>args</i>?</a><dd> This command is used to query and change the vertical position of the information displayed in the treectrl's window. @@ -2104,7 +2122,7 @@ It can take any of the following forms: <br><br> <dl> -<dt><a name="127"><i class='arg'>pathName</i> <b class='cmd'>yview</b></a><dd> +<dt><a name="130"><i class='arg'>pathName</i> <b class='cmd'>yview</b></a><dd> Returns a list containing two elements. Each element is a real fraction between 0 and 1; together they describe @@ -2115,7 +2133,7 @@ These are the same values passed to scrollbars via the <strong>-yscrollcommand</ option. <br><br> -<dt><a name="128"><i class='arg'>pathName</i> <b class='cmd'>yview moveto</b> <i class='arg'>fraction</i></a><dd> +<dt><a name="131"><i class='arg'>pathName</i> <b class='cmd'>yview moveto</b> <i class='arg'>fraction</i></a><dd> Adjusts the view in the window so that <i class='arg'>fraction</i> of the tree's area is off-screen to the top. @@ -2123,7 +2141,7 @@ area is off-screen to the top. A <strong><Scroll-y></strong> event is generated. <br><br> -<dt><a name="129"><i class='arg'>pathName</i> <b class='cmd'>yview scroll</b> <i class='arg'>number</i> <i class='arg'>what</i></a><dd> +<dt><a name="132"><i class='arg'>pathName</i> <b class='cmd'>yview scroll</b> <i class='arg'>number</i> <i class='arg'>what</i></a><dd> This command adjusts the view in the window up or down according to <i class='arg'>number</i> and <i class='arg'>what</i>. diff --git a/doc/treectrl.man b/doc/treectrl.man index fd0ad8b..4069099 100644 --- a/doc/treectrl.man +++ b/doc/treectrl.man @@ -3,7 +3,7 @@ See the file "license.terms" for information on usage and redistribution of this file, and for a DISCLAIMER OF ALL WARRANTIES. - $Id: treectrl.man,v 1.7 2004/08/09 02:40:43 treectrl Exp $} + $Id: treectrl.man,v 1.8 2004/08/11 00:29:56 treectrl Exp $} ][manpage_begin treectrl n 1.0] [moddesc {Tk Commands}] [titledesc {Create and manipulate hierarchical multicolumn widgets}] @@ -328,22 +328,7 @@ command. [call [arg pathName] [cmd collapse] [opt [option -recurse]] \ [opt [arg {itemDesc ...}]]] -Switches off the [const open] state of the item(s) -described by [arg itemDesc]. -If the item has descendants, they are no longer displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options [option -closedbuttonimage] or [option -closedbuttonbitmap], -or a [emph +] sign if no image or bitmap is configured. -If the item is already closed, this command has no effect. -[arg ItemDesc] may also be the string [const all], -in which case all items of the treectrl widget are collapsed. -If [option -recurse] is specified, all descendants of [arg itemDesc] -will also be collapsed. -For every item, that actually will be collapsed, -two events are generated: -a [const <Collapse-before>] event before the item state is changed, -and a [const <Collapse-after>] event after the item state was changed. +Use [cmd {item collapse}] instead. [call [arg pathName] [cmd column] [arg option] [arg column] \ [opt [arg {arg ...}]]] @@ -659,21 +644,7 @@ such as [const rect] or [const text]. [call [arg pathName] [cmd expand] [opt [option -recurse]] \ [opt [arg {itemDesc ...}]]] -Switches on the [const open] state of the item(s) described by [arg itemDesc]. -If the item has descendants, they are now displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options [option -openbuttonimage] or [option -openbuttonbitmap], -or a [emph -] sign if no image or bitmap is configured. -If the item is already open, this command has no effect. -[arg ItemDesc] may also be the string [const all], -in which case all items of the treectrl widget are expanded. -If [option -recurse] is specified, all descendants of [arg itemDesc] -will also be expanded. -For every item, that actually will be expanded, -two events are generated: -an [const <Expand-before>] event before the item state is changed, -and an [const <Expand-after>] event after the item state was changed. +Use [cmd {item expand}] instead. [call [arg pathName] [cmd identify] [arg x] [arg y]] Returns a list containing some diagnostics about what @@ -747,6 +718,24 @@ Returns a list containing the numerical indexes of all children of the item specified by [arg itemDesc] in the correct order from the first child to the last child. +[call [arg pathName] [cmd {item collapse}] [arg itemDesc] [opt [option -recurse]]] +Switches off the [const open] state of the item(s) +described by [arg itemDesc]. +If the item has descendants, they are no longer displayed. +If the item is configured to have a button, +the button will now display the image or bitmap configured with the +widget options [option -closedbuttonimage] or [option -closedbuttonbitmap], +or a [emph +] sign if no image or bitmap is configured. +If the item is already closed, this command has no effect. +[arg ItemDesc] may also be the string [const all], +in which case all items of the treectrl widget are collapsed. +If [option -recurse] is specified, all descendants of [arg itemDesc] +will also be collapsed. +For every item, that actually will be collapsed, +two events are generated: +a [const <Collapse-before>] event before the item state is changed, +and a [const <Collapse-after>] event after the item state was changed. + [call [arg pathName] [cmd {item complex}] [arg itemDesc] [arg list] [arg ...]] Modifies the elements of the item described by [arg itemDesc]. For every column of the treectrl there may be specified one [arg list], @@ -867,6 +856,23 @@ modifies the given option(s) to have the given value(s) in the in this case the command returns an empty string. [list_end] +[call [arg pathName] [cmd {item expand}] [arg itemDesc] [opt [option -recurse]]] +Switches on the [const open] state of the item(s) described by [arg itemDesc]. +If the item has descendants, they are now displayed. +If the item is configured to have a button, +the button will now display the image or bitmap configured with the +widget options [option -openbuttonimage] or [option -openbuttonbitmap], +or a [emph -] sign if no image or bitmap is configured. +If the item is already open, this command has no effect. +[arg ItemDesc] may also be the string [const all], +in which case all items of the treectrl widget are expanded. +If [option -recurse] is specified, all descendants of [arg itemDesc] +will also be expanded. +For every item, that actually will be expanded, +two events are generated: +an [const <Expand-before>] event before the item state is changed, +and an [const <Expand-after>] event after the item state was changed. + [call [arg pathName] [cmd {item firstchild}] [arg parent] [opt [arg child]]] If [arg child] is not specified, returns the numerical index of the first child of the item described by [arg parent]. @@ -1077,6 +1083,16 @@ this command is provided as a convenience. Use the [cmd "item element configure"] command if you want to set the text of a specific text element. +[call [arg pathName] [cmd {item toggle}] [arg itemDesc] [opt [option -recurse]]] +Changes the [const open] state of the item(s) described by [arg itemDesc]. +If the state is currently switched off, +this command does the same as the [cmd {item expand}] widget command, +otherwise the same as the [cmd {item collapse}] widget command. +[arg ItemDesc] may also be the string [const all], +in which case the state of all items of the treectrl widget are toggled. +If [option -recurse] is specified, the state of all descendants of +[arg itemDesc] will also be toggled. + [list_end] [call [arg pathName] [cmd marquee] [arg option] [opt [arg {arg ...}]]] @@ -1568,14 +1584,7 @@ Returns a list containing the names of all existing styles. [call [arg pathName] [cmd toggle] [opt [option -recurse]] \ [opt [arg {itemDesc ...}]]] -Changes the [const open] state of the item(s) described by [arg itemDesc]. -If the state is currently switched off, -this command does the same as the [cmd expand] widget command, -otherwise the same as the [cmd collapse] widget command. -[arg ItemDesc] may also be the string [const all], -in which case the state of all items of the treectrl widget are toggled. -If [option -recurse] is specified, the state of all descendants of -[arg itemDesc] will also be toggles. +Use [cmd {item toggle}] instead. [call [arg pathName] [cmd xview] [opt [arg args]]] This command is used to query and change the horizontal position of the diff --git a/doc/treectrl.n b/doc/treectrl.n index b5d7d9d..384e288 100644 --- a/doc/treectrl.n +++ b/doc/treectrl.n @@ -6,7 +6,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" $Id: treectrl.n,v 1.24 2004/08/09 02:40:43 treectrl Exp $ +'\" $Id: treectrl.n,v 1.25 2004/08/11 00:29:56 treectrl Exp $ .so man.macros .TH "treectrl" n 1.0 "Tk Commands" .BS @@ -107,6 +107,8 @@ package require \fBtreectrl 1.0\fR .sp \fIpathName\fR \fBitem children\fR \fIitemDesc\fR\fR .sp +\fIpathName\fR \fBitem collapse\fR \fIitemDesc\fR ?\fB-recurse\fR?\fR +.sp \fIpathName\fR \fBitem complex\fR \fIitemDesc\fR \fIlist\fR \fI...\fR\fR .sp \fIpathName\fR \fBitem configure\fR \fIitemDesc\fR ?\fIoption\fR? ?\fIvalue\fR? ?\fIoption value ...\fR?\fR @@ -125,6 +127,8 @@ package require \fBtreectrl 1.0\fR .sp \fIpathName\fR \fBitem element configure\fR \fIitemDesc\fR \fIcolumn\fR \fIelement\fR ?\fIoption\fR? ?\fIvalue\fR? ?\fIoption value ...\fR?\fR .sp +\fIpathName\fR \fBitem expand\fR \fIitemDesc\fR ?\fB-recurse\fR?\fR +.sp \fIpathName\fR \fBitem firstchild\fR \fIparent\fR ?\fIchild\fR?\fR .sp \fIpathName\fR \fBitem index\fR \fIitemDesc\fR\fR @@ -167,6 +171,8 @@ package require \fBtreectrl 1.0\fR .sp \fIpathName\fR \fBitem text\fR \fIitemDesc\fR \fIcolumn\fR ?\fItext\fR? ?\fIcolumn text ...\fR?\fR .sp +\fIpathName\fR \fBitem toggle\fR \fIitemDesc\fR ?\fB-recurse\fR?\fR +.sp \fIpathName\fR \fBmarquee\fR \fIoption\fR ?\fIarg ...\fR?\fR .sp \fIpathName\fR \fBmarquee anchor\fR ?\fIx y\fR?\fR @@ -776,22 +782,7 @@ by \fIoption\fR. command. .TP \fIpathName\fR \fBcollapse\fR ?\fB-recurse\fR? ?\fIitemDesc ...\fR?\fR -Switches off the \fBopen\fR state of the item(s) -described by \fIitemDesc\fR. -If the item has descendants, they are no longer displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options \fB-closedbuttonimage\fR or \fB-closedbuttonbitmap\fR, -or a \fI+\fR sign if no image or bitmap is configured. -If the item is already closed, this command has no effect. -\fIItemDesc\fR may also be the string \fBall\fR, -in which case all items of the treectrl widget are collapsed. -If \fB-recurse\fR is specified, all descendants of \fIitemDesc\fR -will also be collapsed. -For every item, that actually will be collapsed, -two events are generated: -a \fB<Collapse-before>\fR event before the item state is changed, -and a \fB<Collapse-after>\fR event after the item state was changed. +Use \fBitem collapse\fR instead. .TP \fIpathName\fR \fBcolumn\fR \fIoption\fR \fIcolumn\fR ?\fIarg ...\fR?\fR This command is used to manipulate the columns of the treectrl widget @@ -1094,21 +1085,7 @@ such as \fBrect\fR or \fBtext\fR. .RE .TP \fIpathName\fR \fBexpand\fR ?\fB-recurse\fR? ?\fIitemDesc ...\fR?\fR -Switches on the \fBopen\fR state of the item(s) described by \fIitemDesc\fR. -If the item has descendants, they are now displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options \fB-openbuttonimage\fR or \fB-openbuttonbitmap\fR, -or a \fI-\fR sign if no image or bitmap is configured. -If the item is already open, this command has no effect. -\fIItemDesc\fR may also be the string \fBall\fR, -in which case all items of the treectrl widget are expanded. -If \fB-recurse\fR is specified, all descendants of \fIitemDesc\fR -will also be expanded. -For every item, that actually will be expanded, -two events are generated: -an \fB<Expand-before>\fR event before the item state is changed, -and an \fB<Expand-after>\fR event after the item state was changed. +Use \fBitem expand\fR instead. .TP \fIpathName\fR \fBidentify\fR \fIx\fR \fIy\fR\fR Returns a list containing some diagnostics about what @@ -1179,6 +1156,24 @@ Returns a list containing the numerical indexes of all children of the item specified by \fIitemDesc\fR in the correct order from the first child to the last child. .TP +\fIpathName\fR \fBitem collapse\fR \fIitemDesc\fR ?\fB-recurse\fR?\fR +Switches off the \fBopen\fR state of the item(s) +described by \fIitemDesc\fR. +If the item has descendants, they are no longer displayed. +If the item is configured to have a button, +the button will now display the image or bitmap configured with the +widget options \fB-closedbuttonimage\fR or \fB-closedbuttonbitmap\fR, +or a \fI+\fR sign if no image or bitmap is configured. +If the item is already closed, this command has no effect. +\fIItemDesc\fR may also be the string \fBall\fR, +in which case all items of the treectrl widget are collapsed. +If \fB-recurse\fR is specified, all descendants of \fIitemDesc\fR +will also be collapsed. +For every item, that actually will be collapsed, +two events are generated: +a \fB<Collapse-before>\fR event before the item state is changed, +and a \fB<Collapse-after>\fR event after the item state was changed. +.TP \fIpathName\fR \fBitem complex\fR \fIitemDesc\fR \fIlist\fR \fI...\fR\fR Modifies the elements of the item described by \fIitemDesc\fR. For every column of the treectrl there may be specified one \fIlist\fR, @@ -1292,6 +1287,23 @@ modifies the given option(s) to have the given value(s) in the in this case the command returns an empty string. .RE .TP +\fIpathName\fR \fBitem expand\fR \fIitemDesc\fR ?\fB-recurse\fR?\fR +Switches on the \fBopen\fR state of the item(s) described by \fIitemDesc\fR. +If the item has descendants, they are now displayed. +If the item is configured to have a button, +the button will now display the image or bitmap configured with the +widget options \fB-openbuttonimage\fR or \fB-openbuttonbitmap\fR, +or a \fI-\fR sign if no image or bitmap is configured. +If the item is already open, this command has no effect. +\fIItemDesc\fR may also be the string \fBall\fR, +in which case all items of the treectrl widget are expanded. +If \fB-recurse\fR is specified, all descendants of \fIitemDesc\fR +will also be expanded. +For every item, that actually will be expanded, +two events are generated: +an \fB<Expand-before>\fR event before the item state is changed, +and an \fB<Expand-after>\fR event after the item state was changed. +.TP \fIpathName\fR \fBitem firstchild\fR \fIparent\fR ?\fIchild\fR?\fR If \fIchild\fR is not specified, returns the numerical index of the first child of the item described by \fIparent\fR. @@ -1486,6 +1498,16 @@ then the text(s) of item in \fIcolumn\fR will be set to \fItext\fR. Note that this command is provided as a convenience. Use the \fBitem element configure\fR command if you want to set the text of a specific text element. +.TP +\fIpathName\fR \fBitem toggle\fR \fIitemDesc\fR ?\fB-recurse\fR?\fR +Changes the \fBopen\fR state of the item(s) described by \fIitemDesc\fR. +If the state is currently switched off, +this command does the same as the \fBitem expand\fR widget command, +otherwise the same as the \fBitem collapse\fR widget command. +\fIItemDesc\fR may also be the string \fBall\fR, +in which case the state of all items of the treectrl widget are toggled. +If \fB-recurse\fR is specified, the state of all descendants of +\fIitemDesc\fR will also be toggled. .RE .TP \fIpathName\fR \fBmarquee\fR \fIoption\fR ?\fIarg ...\fR?\fR @@ -1958,14 +1980,7 @@ Returns a list containing the names of all existing styles. .RE .TP \fIpathName\fR \fBtoggle\fR ?\fB-recurse\fR? ?\fIitemDesc ...\fR?\fR -Changes the \fBopen\fR state of the item(s) described by \fIitemDesc\fR. -If the state is currently switched off, -this command does the same as the \fBexpand\fR widget command, -otherwise the same as the \fBcollapse\fR widget command. -\fIItemDesc\fR may also be the string \fBall\fR, -in which case the state of all items of the treectrl widget are toggled. -If \fB-recurse\fR is specified, the state of all descendants of -\fIitemDesc\fR will also be toggles. +Use \fBitem toggle\fR instead. .TP \fIpathName\fR \fBxview\fR ?\fIargs\fR?\fR This command is used to query and change the horizontal position of the |