diff options
Diffstat (limited to 'doc/treectrl.html')
| -rw-r--r-- | doc/treectrl.html | 768 |
1 files changed, 462 insertions, 306 deletions
diff --git a/doc/treectrl.html b/doc/treectrl.html index dd34d5d..90372f0 100644 --- a/doc/treectrl.html +++ b/doc/treectrl.html @@ -1,14 +1,14 @@ -<! -- 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.12 2005/05/11 03:31:32 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.13 2005/05/13 20:50:19 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.12 2005/05/11 03:31:32 treectrl Exp $ treectrl.n +<! -- CVS: $Id: treectrl.html,v 1.13 2005/05/13 20:50:19 treectrl Exp $ treectrl.n --> <body> -<h1> treectrl(n) 1.2 "Tk Commands"</h1> +<h1> treectrl(n) 2.0 "Tk Commands"</h1> <h2><a name="name">NAME</a></h2> <p> <p> treectrl - Create and manipulate hierarchical multicolumn widgets @@ -18,7 +18,7 @@ <h2><a name="synopsis">SYNOPSIS</a></h2> <p> -package require <b>treectrl 1.2</b><br> +package require <b>treectrl 2.0</b><br> <br><table border=1 width=100% cellspacing=0 cellpadding=0><tr bgcolor=lightyellow><td bgcolor=lightyellow><table 0 width=100% cellspacing=0 cellpadding=0><tr valign=top ><td ><a href="#1"><b class='cmd'>treectrl</b> <i class='arg'>pathName</i> ?<i class='arg'>options</i>?</a></td></tr> <tr valign=top ><td ><a href="#2"><i class='arg'>pathName</i> <b class='cmd'>activate</b> <i class='arg'>itemDesc</i></a></td></tr> <tr valign=top ><td ><a href="#3"><i class='arg'>pathName</i> <b class='cmd'>canvasx</b> <i class='arg'>screenx</i></a></td></tr> @@ -29,131 +29,139 @@ package require <b>treectrl 1.2</b><br> <tr valign=top ><td ><a href="#8"><i class='arg'>pathName</i> <b class='cmd'>column bbox</b> <i class='arg'>column</i></a></td></tr> <tr valign=top ><td ><a href="#9"><i class='arg'>pathName</i> <b class='cmd'>column cget</b> <i class='arg'>column</i> <i class='arg'>option</i></a></td></tr> <tr valign=top ><td ><a href="#10"><i class='arg'>pathName</i> <b class='cmd'>column configure</b> <i class='arg'>column</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="#11"><i class='arg'>pathName</i> <b class='cmd'>column create</b> ?<i class='arg'>option value ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#12"><i class='arg'>pathName</i> <b class='cmd'>column delete</b> <i class='arg'>column</i></a></td></tr> -<tr valign=top ><td ><a href="#13"><i class='arg'>pathName</i> <b class='cmd'>column index</b> <i class='arg'>column</i></a></td></tr> -<tr valign=top ><td ><a href="#14"><i class='arg'>pathName</i> <b class='cmd'>column move</b> <i class='arg'>column</i> <i class='arg'>before</i></a></td></tr> -<tr valign=top ><td ><a href="#15"><i class='arg'>pathName</i> <b class='cmd'>column neededwidth</b> <i class='arg'>column</i></a></td></tr> -<tr valign=top ><td ><a href="#16"><i class='arg'>pathName</i> <b class='cmd'>column width</b> <i class='arg'>column</i></a></td></tr> -<tr valign=top ><td ><a href="#17"><i class='arg'>pathName</i> <b class='cmd'>compare</b> <i class='arg'>itemDesc1</i> <i class='arg'>op</i> <i class='arg'>itemDesc2</i></a></td></tr> -<tr valign=top ><td ><a href="#18"><i class='arg'>pathName</i> <b class='cmd'>configure</b> ?<i class='arg'>option</i>? ?<i class='arg'>value option value ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#19"><i class='arg'>pathName</i> <b class='cmd'>contentbox</b></a></td></tr> -<tr valign=top ><td ><a href="#20"><i class='arg'>pathName</i> <b class='cmd'>debug</b> <i class='arg'>option</i> ?<i class='arg'>arg arg ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#21"><i class='arg'>pathName</i> <b class='cmd'>debug cget</b> <i class='arg'>element</i> <i class='arg'>option</i></a></td></tr> -<tr valign=top ><td ><a href="#22"><i class='arg'>pathName</i> <b class='cmd'>debug configure</b> <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="#23"><i class='arg'>pathName</i> <b class='cmd'>debug dinfo</b></a></td></tr> -<tr valign=top ><td ><a href="#24"><i class='arg'>pathName</i> <b class='cmd'>debug scroll</b></a></td></tr> -<tr valign=top ><td ><a href="#25"><i class='arg'>pathName</i> <b class='cmd'>depth</b> ?<i class='arg'>itemDesc</i>?</a></td></tr> -<tr valign=top ><td ><a href="#26"><i class='arg'>pathName</i> <b class='cmd'>dragimage</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#27"><i class='arg'>pathName</i> <b class='cmd'>dragimage add</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="#28"><i class='arg'>pathName</i> <b class='cmd'>dragimage cget</b> <i class='arg'>option</i></a></td></tr> -<tr valign=top ><td ><a href="#29"><i class='arg'>pathName</i> <b class='cmd'>dragimage clear</b></a></td></tr> -<tr valign=top ><td ><a href="#30"><i class='arg'>pathName</i> <b class='cmd'>dragimage 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="#31"><i class='arg'>pathName</i> <b class='cmd'>dragimage offset</b> ?<i class='arg'>x y</i>?</a></td></tr> -<tr valign=top ><td ><a href="#32"><i class='arg'>pathName</i> <b class='cmd'>element</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="#33"><i class='arg'>pathName</i> <b class='cmd'>element cget</b> <i class='arg'>element</i> <i class='arg'>option</i></a></td></tr> -<tr valign=top ><td ><a href="#34"><i class='arg'>pathName</i> <b class='cmd'>element configure</b> <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="#35"><i class='arg'>pathName</i> <b class='cmd'>element create</b> <i class='arg'>element</i> <i class='arg'>type</i> ?<i class='arg'>option value ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#36"><i class='arg'>pathName</i> <b class='cmd'>element delete</b> ?<i class='arg'>element ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#37"><i class='arg'>pathName</i> <b class='cmd'>element names</b></a></td></tr> -<tr valign=top ><td ><a href="#38"><i class='arg'>pathName</i> <b class='cmd'>element type</b> <i class='arg'>element</i></a></td></tr> -<tr valign=top ><td ><a href="#39"><i class='arg'>pathName</i> <b class='cmd'>expand</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#40"><i class='arg'>pathName</i> <b class='cmd'>identify</b> <i class='arg'>x</i> <i class='arg'>y</i></a></td></tr> -<tr valign=top ><td ><a href="#41"><i class='arg'>pathName</i> <b class='cmd'>index</b> <i class='arg'>itemDesc</i></a></td></tr> -<tr valign=top ><td ><a href="#42"><i class='arg'>pathName</i> <b class='cmd'>item</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a></td></tr> -<tr valign=top ><td ><a href="#43"><i class='arg'>pathName</i> <b class='cmd'>item ancestors</b> <i class='arg'>itemDesc</i></a></td></tr> -<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 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'>object</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>? ?<i class='arg'>percentsCommand</i>?</a></td></tr> -<tr valign=top ><td ><a href="#93"><i class='arg'>pathName</i> <b class='cmd'>notify install</b> <i class='arg'>pattern</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 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="#95"><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="#96"><i class='arg'>pathName</i> <b class='cmd'>notify linkage</b> <i class='arg'>pattern</i></a></td></tr> -<tr valign=top ><td ><a href="#97"><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="#98"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall</b> <i class='arg'>pattern</i></a></td></tr> -<tr valign=top ><td ><a href="#99"><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="#100"><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="#101"><i class='arg'>pathName</i> <b class='cmd'>numcolumns</b></a></td></tr> -<tr valign=top ><td ><a href="#102"><i class='arg'>pathName</i> <b class='cmd'>numitems</b></a></td></tr> -<tr valign=top ><td ><a href="#103"><i class='arg'>pathName</i> <b class='cmd'>orphans</b></a></td></tr> -<tr valign=top ><td ><a href="#104"><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="#105"><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="#106"><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="#107"><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="#108"><i class='arg'>pathName</i> <b class='cmd'>state names</b></a></td></tr> -<tr valign=top ><td ><a href="#109"><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="#110"><i class='arg'>pathName</i> <b class='cmd'>see</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</b> <i class='arg'>option</i> <i class='arg'>arg</i></a></td></tr> -<tr valign=top ><td ><a href="#112"><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="#113"><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="#114"><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="#115"><i class='arg'>pathName</i> <b class='cmd'>selection count</b></a></td></tr> -<tr valign=top ><td ><a href="#116"><i class='arg'>pathName</i> <b class='cmd'>selection get</b></a></td></tr> -<tr valign=top ><td ><a href="#117"><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="#118"><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="#119"><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="#120"><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="#121"><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="#122"><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="#123"><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="#124"><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="#125"><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="#126"><i class='arg'>pathName</i> <b class='cmd'>style names</b></a></td></tr> -<tr valign=top ><td ><a href="#127"><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="#128"><i class='arg'>pathName</i> <b class='cmd'>xview</b> ?<i class='arg'>args</i>?</a></td></tr> -<tr valign=top ><td ><a href="#129"><i class='arg'>pathName</i> <b class='cmd'>xview</b></a></td></tr> -<tr valign=top ><td ><a href="#130"><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="#131"><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="#132"><i class='arg'>pathName</i> <b class='cmd'>yview</b> ?<i class='arg'>args</i>?</a></td></tr> -<tr valign=top ><td ><a href="#133"><i class='arg'>pathName</i> <b class='cmd'>yview</b></a></td></tr> -<tr valign=top ><td ><a href="#134"><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="#135"><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="#11"><i class='arg'>pathName</i> <b class='cmd'>column compare</b> <i class='arg'>column1</i> <i class='arg'>op</i> <i class='arg'>column2</i></a></td></tr> +<tr valign=top ><td ><a href="#12"><i class='arg'>pathName</i> <b class='cmd'>column count</b></a></td></tr> +<tr valign=top ><td ><a href="#13"><i class='arg'>pathName</i> <b class='cmd'>column create</b> ?<i class='arg'>option value ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#14"><i class='arg'>pathName</i> <b class='cmd'>column delete</b> <i class='arg'>column</i></a></td></tr> +<tr valign=top ><td ><a href="#15"><i class='arg'>pathName</i> <b class='cmd'>column index</b> <i class='arg'>column</i></a></td></tr> +<tr valign=top ><td ><a href="#16"><i class='arg'>pathName</i> <b class='cmd'>column id</b> <i class='arg'>column</i></a></td></tr> +<tr valign=top ><td ><a href="#17"><i class='arg'>pathName</i> <b class='cmd'>column list</b> ?<i class='arg'>-visible</i>?</a></td></tr> +<tr valign=top ><td ><a href="#18"><i class='arg'>pathName</i> <b class='cmd'>column move</b> <i class='arg'>column</i> <i class='arg'>before</i></a></td></tr> +<tr valign=top ><td ><a href="#19"><i class='arg'>pathName</i> <b class='cmd'>column neededwidth</b> <i class='arg'>column</i></a></td></tr> +<tr valign=top ><td ><a href="#20"><i class='arg'>pathName</i> <b class='cmd'>column order</b> <i class='arg'>column</i> ?<i class='arg'>-visible</i>?</a></td></tr> +<tr valign=top ><td ><a href="#21"><i class='arg'>pathName</i> <b class='cmd'>column width</b> <i class='arg'>column</i></a></td></tr> +<tr valign=top ><td ><a href="#22"><i class='arg'>pathName</i> <b class='cmd'>compare</b> <i class='arg'>itemDesc1</i> <i class='arg'>op</i> <i class='arg'>itemDesc2</i></a></td></tr> +<tr valign=top ><td ><a href="#23"><i class='arg'>pathName</i> <b class='cmd'>configure</b> ?<i class='arg'>option</i>? ?<i class='arg'>value option value ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#24"><i class='arg'>pathName</i> <b class='cmd'>contentbox</b></a></td></tr> +<tr valign=top ><td ><a href="#25"><i class='arg'>pathName</i> <b class='cmd'>debug</b> <i class='arg'>option</i> ?<i class='arg'>arg arg ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#26"><i class='arg'>pathName</i> <b class='cmd'>debug cget</b> <i class='arg'>element</i> <i class='arg'>option</i></a></td></tr> +<tr valign=top ><td ><a href="#27"><i class='arg'>pathName</i> <b class='cmd'>debug configure</b> <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="#28"><i class='arg'>pathName</i> <b class='cmd'>debug dinfo</b></a></td></tr> +<tr valign=top ><td ><a href="#29"><i class='arg'>pathName</i> <b class='cmd'>debug scroll</b></a></td></tr> +<tr valign=top ><td ><a href="#30"><i class='arg'>pathName</i> <b class='cmd'>depth</b> ?<i class='arg'>itemDesc</i>?</a></td></tr> +<tr valign=top ><td ><a href="#31"><i class='arg'>pathName</i> <b class='cmd'>dragimage</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#32"><i class='arg'>pathName</i> <b class='cmd'>dragimage add</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="#33"><i class='arg'>pathName</i> <b class='cmd'>dragimage cget</b> <i class='arg'>option</i></a></td></tr> +<tr valign=top ><td ><a href="#34"><i class='arg'>pathName</i> <b class='cmd'>dragimage clear</b></a></td></tr> +<tr valign=top ><td ><a href="#35"><i class='arg'>pathName</i> <b class='cmd'>dragimage 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="#36"><i class='arg'>pathName</i> <b class='cmd'>dragimage offset</b> ?<i class='arg'>x y</i>?</a></td></tr> +<tr valign=top ><td ><a href="#37"><i class='arg'>pathName</i> <b class='cmd'>element</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="#38"><i class='arg'>pathName</i> <b class='cmd'>element cget</b> <i class='arg'>element</i> <i class='arg'>option</i></a></td></tr> +<tr valign=top ><td ><a href="#39"><i class='arg'>pathName</i> <b class='cmd'>element configure</b> <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="#40"><i class='arg'>pathName</i> <b class='cmd'>element create</b> <i class='arg'>element</i> <i class='arg'>type</i> ?<i class='arg'>option value ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#41"><i class='arg'>pathName</i> <b class='cmd'>element delete</b> ?<i class='arg'>element ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#42"><i class='arg'>pathName</i> <b class='cmd'>element names</b></a></td></tr> +<tr valign=top ><td ><a href="#43"><i class='arg'>pathName</i> <b class='cmd'>element type</b> <i class='arg'>element</i></a></td></tr> +<tr valign=top ><td ><a href="#44"><i class='arg'>pathName</i> <b class='cmd'>expand</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#45"><i class='arg'>pathName</i> <b class='cmd'>identify</b> <i class='arg'>x</i> <i class='arg'>y</i></a></td></tr> +<tr valign=top ><td ><a href="#46"><i class='arg'>pathName</i> <b class='cmd'>index</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</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a></td></tr> +<tr valign=top ><td ><a href="#48"><i class='arg'>pathName</i> <b class='cmd'>item ancestors</b> <i class='arg'>itemDesc</i></a></td></tr> +<tr valign=top ><td ><a href="#49"><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="#50"><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="#51"><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="#52"><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="#53"><i class='arg'>pathName</i> <b class='cmd'>item compare</b> <i class='arg'>itemDesc1</i> <i class='arg'>op</i> <i class='arg'>itemDesc2</i></a></td></tr> +<tr valign=top ><td ><a href="#54"><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="#55"><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="#56"><i class='arg'>pathName</i> <b class='cmd'>item count</b></a></td></tr> +<tr valign=top ><td ><a href="#57"><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="#58"><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="#59"><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="#60"><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="#61"><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="#62"><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="#63"><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="#64"><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="#65"><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="#66"><i class='arg'>pathName</i> <b class='cmd'>item id</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 isancestor</b> <i class='arg'>itemDesc</i> <i class='arg'>descendant</i></a></td></tr> +<tr valign=top ><td ><a href="#68"><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="#69"><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="#70"><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="#71"><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="#72"><i class='arg'>pathName</i> <b class='cmd'>item order</b> <i class='arg'>itemDesc</i> ?<i class='arg'>-visible</i>?</a></td></tr> +<tr valign=top ><td ><a href="#73"><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="#74"><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="#75"><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="#76"><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="#77"><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="#78"><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="#79"><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="#80"><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="#81"><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="#82"><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="#83"><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="#84"><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="#85"><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="#86"><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="#87"><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="#88"><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="#89"><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="#90"><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="#91"><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="#92"><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="#93"><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="#94"><i class='arg'>pathName</i> <b class='cmd'>marquee identify</b></a></td></tr> +<tr valign=top ><td ><a href="#95"><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="#96"><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="#97"><i class='arg'>pathName</i> <b class='cmd'>notify configure</b> <i class='arg'>object</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="#98"><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="#99"><i class='arg'>pathName</i> <b class='cmd'>notify eventnames</b></a></td></tr> +<tr valign=top ><td ><a href="#100"><i class='arg'>pathName</i> <b class='cmd'>notify generate</b> <i class='arg'>pattern</i> ?<i class='arg'>charMap</i>? ?<i class='arg'>percentsCommand</i>?</a></td></tr> +<tr valign=top ><td ><a href="#101"><i class='arg'>pathName</i> <b class='cmd'>notify install</b> <i class='arg'>pattern</i> ?<i class='arg'>percentsCommand</i>?</a></td></tr> +<tr valign=top ><td ><a href="#102"><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="#103"><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="#104"><i class='arg'>pathName</i> <b class='cmd'>notify linkage</b> <i class='arg'>pattern</i></a></td></tr> +<tr valign=top ><td ><a href="#105"><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="#106"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall</b> <i class='arg'>pattern</i></a></td></tr> +<tr valign=top ><td ><a href="#107"><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="#108"><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="#109"><i class='arg'>pathName</i> <b class='cmd'>numcolumns</b></a></td></tr> +<tr valign=top ><td ><a href="#110"><i class='arg'>pathName</i> <b class='cmd'>numitems</b></a></td></tr> +<tr valign=top ><td ><a href="#111"><i class='arg'>pathName</i> <b class='cmd'>orphans</b></a></td></tr> +<tr valign=top ><td ><a href="#112"><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="#113"><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="#114"><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="#115"><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="#116"><i class='arg'>pathName</i> <b class='cmd'>state names</b></a></td></tr> +<tr valign=top ><td ><a href="#117"><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="#118"><i class='arg'>pathName</i> <b class='cmd'>see</b> <i class='arg'>itemDesc</i></a></td></tr> +<tr valign=top ><td ><a href="#119"><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="#120"><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="#121"><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="#122"><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="#123"><i class='arg'>pathName</i> <b class='cmd'>selection count</b></a></td></tr> +<tr valign=top ><td ><a href="#124"><i class='arg'>pathName</i> <b class='cmd'>selection get</b></a></td></tr> +<tr valign=top ><td ><a href="#125"><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="#126"><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="#127"><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="#128"><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="#129"><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="#130"><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="#131"><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="#132"><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="#133"><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="#134"><i class='arg'>pathName</i> <b class='cmd'>style names</b></a></td></tr> +<tr valign=top ><td ><a href="#135"><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="#136"><i class='arg'>pathName</i> <b class='cmd'>xview</b> ?<i class='arg'>args</i>?</a></td></tr> +<tr valign=top ><td ><a href="#137"><i class='arg'>pathName</i> <b class='cmd'>xview</b></a></td></tr> +<tr valign=top ><td ><a href="#138"><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="#139"><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="#140"><i class='arg'>pathName</i> <b class='cmd'>yview</b> ?<i class='arg'>args</i>?</a></td></tr> +<tr valign=top ><td ><a href="#141"><i class='arg'>pathName</i> <b class='cmd'>yview</b></a></td></tr> +<tr valign=top ><td ><a href="#142"><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="#143"><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> @@ -674,7 +682,9 @@ for the column specified by <i class='arg'>column</i>, This command is similar to the <b class='cmd'>configure</b> widget command except that it modifies options associated with the column specified by <i class='arg'>column</i> instead of modifying options for the overall treectrl widget. -<i class='arg'>Column</i> may also be the string <strong>tail</strong> to specify the tail column. +<i class='arg'>Column</i> may be the string <strong>tail</strong> to specify the tail column. +If <i class='arg'>column</i> is the string <strong>all</strong>, at least one option-value pair +must be given; in this case all the columns are configured. If no <i class='arg'>option</i> is specified, the command returns a list describing all of the available options for <i class='arg'>column</i> (see <strong>Tk_ConfigureInfo</strong> for information on the format of this list). @@ -690,30 +700,61 @@ in this case the command returns an empty string. See <a href="#columns">COLUMNS</a> below for details on the options available for columns. <br><br> -<dt><a name="11"><i class='arg'>pathName</i> <b class='cmd'>column create</b> ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="11"><i class='arg'>pathName</i> <b class='cmd'>column compare</b> <i class='arg'>column1</i> <i class='arg'>op</i> <i class='arg'>column2</i></a><dd> + +From both <i class='arg'>column</i>s the index is retrieved +(as returned from the <b class='cmd'>column order</b> widget command). +Then these indexes are compared using the operator <i class='arg'>op</i>, which must +be either <strong><</strong>, <strong><=</strong>, <strong>==</strong>, <strong>>=</strong>, <strong>></strong>, +or <strong>!=</strong>. +The return value of this command is 1 if the comparison evaluated to true, +0 otherwise. + +<br><br> +<dt><a name="12"><i class='arg'>pathName</i> <b class='cmd'>column count</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 +deleted by the <b class='cmd'>column delete</b> widget command. The <strong>tail</strong> column +is not counted. + +<br><br> +<dt><a name="13"><i class='arg'>pathName</i> <b class='cmd'>column create</b> ?<i class='arg'>option value ...</i>?</a><dd> This command creates a new column in the treectrl widget. The new column is placed to the right of all other columns (except the <strong>tail</strong> column). Any <i class='arg'>option</i>-<i class='arg'>value</i> arguments configure the new column according to the -<b class='cmd'>column configure</b> command. The return value is the zero-based index +<b class='cmd'>column configure</b> command. The return value is the unique identifier of the new column. <br><br> -<dt><a name="12"><i class='arg'>pathName</i> <b class='cmd'>column delete</b> <i class='arg'>column</i></a><dd> +<dt><a name="14"><i class='arg'>pathName</i> <b class='cmd'>column delete</b> <i class='arg'>column</i></a><dd> -Deletes the specified <i class='arg'>column</i> from the treectrl widget. -All remaining columns of the treectrl widget will get new column numbers: -in an unchanged order, but with succesive numbers. +Deletes the specified <i class='arg'>column</i> from the treectrl widget. If <i class='arg'>column</i> +is the string <strong>all</strong>, all columns except the tail column are deleted. <br><br> -<dt><a name="13"><i class='arg'>pathName</i> <b class='cmd'>column index</b> <i class='arg'>column</i></a><dd> +<dt><a name="15"><i class='arg'>pathName</i> <b class='cmd'>column index</b> <i class='arg'>column</i></a><dd> -This command returns a decimal string giving the column number -of the column specified by <i class='arg'>column</i>, -which may also be the string <strong>tail</strong> to specify the tail column. +Deprecated. Use <b class='cmd'>column id</b> <br><br> -<dt><a name="14"><i class='arg'>pathName</i> <b class='cmd'>column move</b> <i class='arg'>column</i> <i class='arg'>before</i></a><dd> +<dt><a name="16"><i class='arg'>pathName</i> <b class='cmd'>column id</b> <i class='arg'>column</i></a><dd> + +This command resolves the column description <i class='arg'>column</i> into a unique column +identifier (see <a href="#columndescription">COLUMN DESCRIPTION</a> below). +If the column described by <i class='arg'>column</i> doesn't exist, this command returns +an empty string. + +<br><br> +<dt><a name="17"><i class='arg'>pathName</i> <b class='cmd'>column list</b> ?<i class='arg'>-visible</i>?</a><dd> + +This command returns a list of identifiers for every column (except the tail) +from left to right. If <i class='arg'>-visible</i> is given, only columns whose -visible +option is true are returned. + +<br><br> +<dt><a name="18"><i class='arg'>pathName</i> <b class='cmd'>column move</b> <i class='arg'>column</i> <i class='arg'>before</i></a><dd> Moves the specified <i class='arg'>column</i> to the left of the column specified by <i class='arg'>before</i>. @@ -721,7 +762,7 @@ If <i class='arg'>before</i> is the string <strong>tail</strong>, the column <i class='arg'>column</i> will become the last column. <br><br> -<dt><a name="15"><i class='arg'>pathName</i> <b class='cmd'>column neededwidth</b> <i class='arg'>column</i></a><dd> +<dt><a name="19"><i class='arg'>pathName</i> <b class='cmd'>column neededwidth</b> <i class='arg'>column</i></a><dd> This command returns a decimal string giving the needed width of the column specified by <i class='arg'>column</i>. @@ -729,7 +770,16 @@ The needed width is the maximum of the width of the column header and the width of the <em>widest</em> currently visible item. <br><br> -<dt><a name="16"><i class='arg'>pathName</i> <b class='cmd'>column width</b> <i class='arg'>column</i></a><dd> +<dt><a name="20"><i class='arg'>pathName</i> <b class='cmd'>column order</b> <i class='arg'>column</i> ?<i class='arg'>-visible</i>?</a><dd> + +This command returns a decimal string giving the position of <i class='arg'>column</i> +in the list of columns starting from zero for the leftmost column. +If <i class='arg'>-visible</i> is given, only columns whose -visible +option is true are considered, and -1 is returned if <i class='arg'>column</i>'s -visible +option is false. + +<br><br> +<dt><a name="21"><i class='arg'>pathName</i> <b class='cmd'>column width</b> <i class='arg'>column</i></a><dd> This command returns a decimal string giving the width in pixels of the column specified by <i class='arg'>column</i>, @@ -737,18 +787,12 @@ even if the treectrl is configured to not display the column headers by means of the <strong>-showheader</strong> option. </dl> -<dt><a name="17"><i class='arg'>pathName</i> <b class='cmd'>compare</b> <i class='arg'>itemDesc1</i> <i class='arg'>op</i> <i class='arg'>itemDesc2</i></a><dd> +<dt><a name="22"><i class='arg'>pathName</i> <b class='cmd'>compare</b> <i class='arg'>itemDesc1</i> <i class='arg'>op</i> <i class='arg'>itemDesc2</i></a><dd> -From both items described by the <i class='arg'>itemDesc</i>s the index is retrieved -(as returned from the <b class='cmd'>item index</b> widget command). -Then these indexes are compared using the operator <i class='arg'>op</i>, which must -be either <strong><</strong>, <strong><=</strong>, <strong>==</strong>, <strong>>=</strong>, <strong>></strong>, -or <strong>!=</strong>. -The return value of this command is 1 if the comparison evaulated to true, -0 otherwise. +Deprecated. Use the <b class='cmd'>item compare</b> command instead. <br><br> -<dt><a name="18"><i class='arg'>pathName</i> <b class='cmd'>configure</b> ?<i class='arg'>option</i>? ?<i class='arg'>value option value ...</i>?</a><dd> +<dt><a name="23"><i class='arg'>pathName</i> <b class='cmd'>configure</b> ?<i class='arg'>option</i>? ?<i class='arg'>value option value ...</i>?</a><dd> Query or modify the configuration options of the widget. If no <i class='arg'>option</i> is specified, returns a list describing all of @@ -764,7 +808,7 @@ this case the command returns an empty string. command. <br><br> -<dt><a name="19"><i class='arg'>pathName</i> <b class='cmd'>contentbox</b></a><dd> +<dt><a name="24"><i class='arg'>pathName</i> <b class='cmd'>contentbox</b></a><dd> Returns a list with four elements giving an approximate bounding box for the space used to display the items inside the columns, @@ -772,7 +816,7 @@ i.e. the space of the treectrl widget without the surrounding borders and the column headers. <br><br> -<dt><a name="20"><i class='arg'>pathName</i> <b class='cmd'>debug</b> <i class='arg'>option</i> ?<i class='arg'>arg arg ...</i>?</a><dd> +<dt><a name="25"><i class='arg'>pathName</i> <b class='cmd'>debug</b> <i class='arg'>option</i> ?<i class='arg'>arg arg ...</i>?</a><dd> This command is used to facilitate debugging of the treectrl widget. The exact behavior of the command depends on the <i class='arg'>option</i> argument @@ -781,7 +825,7 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="21"><i class='arg'>pathName</i> <b class='cmd'>debug cget</b> <i class='arg'>element</i> <i class='arg'>option</i></a><dd> +<dt><a name="26"><i class='arg'>pathName</i> <b class='cmd'>debug cget</b> <i class='arg'>element</i> <i class='arg'>option</i></a><dd> This command returns the current value of the debugging option named <i class='arg'>option</i>. @@ -789,7 +833,7 @@ named <i class='arg'>option</i>. <b class='cmd'>debug configure</b> widget command. <br><br> -<dt><a name="22"><i class='arg'>pathName</i> <b class='cmd'>debug configure</b> <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="27"><i class='arg'>pathName</i> <b class='cmd'>debug configure</b> <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 debugging options @@ -845,7 +889,7 @@ Setting this option has only an effect, if the debugging options <strong>-enable</strong> and <strong>-display</strong> are switched on. </dl> -<dt><a name="23"><i class='arg'>pathName</i> <b class='cmd'>debug dinfo</b></a><dd> +<dt><a name="28"><i class='arg'>pathName</i> <b class='cmd'>debug dinfo</b></a><dd> For every of the treectrl widget a line with some internal valuess info about all items @@ -853,12 +897,12 @@ is printed to stdout. The command returns the empty string. <br><br> -<dt><a name="24"><i class='arg'>pathName</i> <b class='cmd'>debug scroll</b></a><dd> +<dt><a name="29"><i class='arg'>pathName</i> <b class='cmd'>debug scroll</b></a><dd> Returns a string useful for debugging vertical scrolling. </dl> -<dt><a name="25"><i class='arg'>pathName</i> <b class='cmd'>depth</b> ?<i class='arg'>itemDesc</i>?</a><dd> +<dt><a name="30"><i class='arg'>pathName</i> <b class='cmd'>depth</b> ?<i class='arg'>itemDesc</i>?</a><dd> If the additional argument <i class='arg'>itemDesc</i> is specified, returns a decimal string giving the depth of @@ -868,7 +912,7 @@ If no <i class='arg'>itemDesc</i> is specified, the maximum depth of all items in the treectrl widget is returned instead. <br><br> -<dt><a name="26"><i class='arg'>pathName</i> <b class='cmd'>dragimage</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a><dd> +<dt><a name="31"><i class='arg'>pathName</i> <b class='cmd'>dragimage</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a><dd> This command is used to manipulate the dragimage, one or more dotted lines around rectangular regions of the treectrl widget. @@ -878,7 +922,7 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="27"><i class='arg'>pathName</i> <b class='cmd'>dragimage add</b> <i class='arg'>itemDesc</i> ?<i class='arg'>column</i>? ?<i class='arg'>element</i>?</a><dd> +<dt><a name="32"><i class='arg'>pathName</i> <b class='cmd'>dragimage add</b> <i class='arg'>itemDesc</i> ?<i class='arg'>column</i>? ?<i class='arg'>element</i>?</a><dd> Adds the shapes of the item described by <i class='arg'>itemDesc</i> to the shapes of the dragimage. @@ -891,7 +935,7 @@ If also <i class='arg'>element</i> is specified, only a rectangle for this one e of the specified item in the given column is added. <br><br> -<dt><a name="28"><i class='arg'>pathName</i> <b class='cmd'>dragimage cget</b> <i class='arg'>option</i></a><dd> +<dt><a name="33"><i class='arg'>pathName</i> <b class='cmd'>dragimage cget</b> <i class='arg'>option</i></a><dd> This command returns the current value of the dragimage option named <i class='arg'>option</i>. @@ -899,13 +943,13 @@ named <i class='arg'>option</i>. <b class='cmd'>dragimage configure</b> widget command. <br><br> -<dt><a name="29"><i class='arg'>pathName</i> <b class='cmd'>dragimage clear</b></a><dd> +<dt><a name="34"><i class='arg'>pathName</i> <b class='cmd'>dragimage clear</b></a><dd> Removes all shapes (if there are any) from the dragimage. This command does not modify the dragimage offset. <br><br> -<dt><a name="30"><i class='arg'>pathName</i> <b class='cmd'>dragimage configure</b> ?<i class='arg'>option</i>? ?<i class='arg'>value</i>? ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="35"><i class='arg'>pathName</i> <b class='cmd'>dragimage 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 dragimage options @@ -931,7 +975,7 @@ Specifies a boolean value which determines whether the dragimage should currently be visible. </dl> -<dt><a name="31"><i class='arg'>pathName</i> <b class='cmd'>dragimage offset</b> ?<i class='arg'>x y</i>?</a><dd> +<dt><a name="36"><i class='arg'>pathName</i> <b class='cmd'>dragimage offset</b> ?<i class='arg'>x y</i>?</a><dd> Returns a list containing the x and y offsets of the dragimage, if no additional arguments are specified. @@ -942,7 +986,7 @@ sets the dragimage offset to the given coordinates <i class='arg'>x</i> and <i c </dl> -<dt><a name="32"><i class='arg'>pathName</i> <b class='cmd'>element</b> <i class='arg'>option</i> ?<i class='arg'>element</i>? ?<i class='arg'>arg arg ...</i>?</a><dd> +<dt><a name="37"><i class='arg'>pathName</i> <b class='cmd'>element</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 elements (see <a href="#elements">ELEMENTS</a> below). The exact behavior of the command depends on the <i class='arg'>option</i> argument @@ -951,7 +995,7 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="33"><i class='arg'>pathName</i> <b class='cmd'>element cget</b> <i class='arg'>element</i> <i class='arg'>option</i></a><dd> +<dt><a name="38"><i class='arg'>pathName</i> <b class='cmd'>element cget</b> <i class='arg'>element</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 element given by <i class='arg'>element</i>. @@ -959,7 +1003,7 @@ associated with the element given by <i class='arg'>element</i>. <b class='cmd'>element configure</b> widget command. <br><br> -<dt><a name="34"><i class='arg'>pathName</i> <b class='cmd'>element configure</b> <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="39"><i class='arg'>pathName</i> <b class='cmd'>element configure</b> <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 the element given by <i class='arg'>element</i> @@ -977,7 +1021,7 @@ in this case the command returns an empty string. See <a href="#elements">ELEMENTS</a> below for details on the options available for elements. <br><br> -<dt><a name="35"><i class='arg'>pathName</i> <b class='cmd'>element create</b> <i class='arg'>element</i> <i class='arg'>type</i> ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="40"><i class='arg'>pathName</i> <b class='cmd'>element create</b> <i class='arg'>element</i> <i class='arg'>type</i> ?<i class='arg'>option value ...</i>?</a><dd> Create a new elememt in <i class='arg'>pathName</i> of type <i class='arg'>type</i> with name <i class='arg'>element</i>. @@ -988,7 +1032,7 @@ on the syntax of this command. This command returns the name for the new element. <br><br> -<dt><a name="36"><i class='arg'>pathName</i> <b class='cmd'>element delete</b> ?<i class='arg'>element ...</i>?</a><dd> +<dt><a name="41"><i class='arg'>pathName</i> <b class='cmd'>element delete</b> ?<i class='arg'>element ...</i>?</a><dd> Deletes each of the named elements and returns an empty string. If an element is deleted while it is still configured @@ -997,23 +1041,23 @@ by means of the <b class='cmd'>style elements</b> widget command, it is also removed from the element lists of these styles. <br><br> -<dt><a name="37"><i class='arg'>pathName</i> <b class='cmd'>element names</b></a><dd> +<dt><a name="42"><i class='arg'>pathName</i> <b class='cmd'>element names</b></a><dd> Returns a list containing the names of all existing elements. <br><br> -<dt><a name="38"><i class='arg'>pathName</i> <b class='cmd'>element type</b> <i class='arg'>element</i></a><dd> +<dt><a name="43"><i class='arg'>pathName</i> <b class='cmd'>element type</b> <i class='arg'>element</i></a><dd> Returns the type of the elements given by <i class='arg'>element</i>, such as <strong>rect</strong> or <strong>text</strong>. </dl> -<dt><a name="39"><i class='arg'>pathName</i> <b class='cmd'>expand</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a><dd> +<dt><a name="44"><i class='arg'>pathName</i> <b class='cmd'>expand</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a><dd> 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> +<dt><a name="45"><i class='arg'>pathName</i> <b class='cmd'>identify</b> <i class='arg'>x</i> <i class='arg'>y</i></a><dd> Returns a list containing some diagnostics about what is displayed at the given windows coordinates <i class='arg'>x</i> and <i class='arg'>y</i>. @@ -1050,14 +1094,12 @@ if the x coordinate is to the right of the elements; nothing otherwise. <br><br> -<dt><a name="41"><i class='arg'>pathName</i> <b class='cmd'>index</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="46"><i class='arg'>pathName</i> <b class='cmd'>index</b> <i class='arg'>itemDesc</i></a><dd> -This command returns a decimal string giving the numerical id -of the item specified by <i class='arg'>itemDesc</i> -(see <a href="#itemdescription">ITEM DESCRIPTION</a> below). +Deprecated. Use <b class='cmd'>item id</b> instead. <br><br> -<dt><a name="42"><i class='arg'>pathName</i> <b class='cmd'>item</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a><dd> +<dt><a name="47"><i class='arg'>pathName</i> <b class='cmd'>item</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a><dd> This command is used to manipulate items. The exact behavior of the command depends on the <i class='arg'>option</i> argument @@ -1066,14 +1108,14 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="43"><i class='arg'>pathName</i> <b class='cmd'>item ancestors</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="48"><i class='arg'>pathName</i> <b class='cmd'>item ancestors</b> <i class='arg'>itemDesc</i></a><dd> Returns a list containing the numerical indexes of all ancestors of the item specified by <i class='arg'>itemDesc</i> from its parent up to the root item. <br><br> -<dt><a name="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><dd> +<dt><a name="49"><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><dd> Returns a list with four elements giving an approximate bounding box for the item described by <i class='arg'>itemDesc</i>. @@ -1084,21 +1126,21 @@ the area of this <i class='arg'>element</i> in <i class='arg'>column</i> of the returned. <br><br> -<dt><a name="45"><i class='arg'>pathName</i> <b class='cmd'>item cget</b> <i class='arg'>itemDesc</i> <i class='arg'>option</i></a><dd> +<dt><a name="50"><i class='arg'>pathName</i> <b class='cmd'>item cget</b> <i class='arg'>itemDesc</i> <i class='arg'>option</i></a><dd> Returns the current value of the configuration option for the item specified by <i class='arg'>itemDesc</i> whose name is <i class='arg'>option</i>. <i class='arg'>Option</i> may have any of the values accepted by the <b class='cmd'>item create</b> command when the item was created. <br><br> -<dt><a name="46"><i class='arg'>pathName</i> <b class='cmd'>item children</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="51"><i class='arg'>pathName</i> <b class='cmd'>item children</b> <i class='arg'>itemDesc</i></a><dd> Returns a list containing the numerical indexes of all children 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 collapse</b> <i class='arg'>itemDesc</i> ?<strong>-recurse</strong>?</a><dd> +<dt><a name="52"><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>. @@ -1118,7 +1160,18 @@ a <strong><Collapse-before></strong> event before the item state is change 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> +<dt><a name="53"><i class='arg'>pathName</i> <b class='cmd'>item compare</b> <i class='arg'>itemDesc1</i> <i class='arg'>op</i> <i class='arg'>itemDesc2</i></a><dd> + +From both items described by the <i class='arg'>itemDesc</i>s the index is retrieved +(as returned from the <b class='cmd'>item order</b> widget command). +Then these indexes are compared using the operator <i class='arg'>op</i>, which must +be either <strong><</strong>, <strong><=</strong>, <strong>==</strong>, <strong>>=</strong>, <strong>></strong>, +or <strong>!=</strong>. +The return value of this command is 1 if the comparison evaluated to true, +0 otherwise. + +<br><br> +<dt><a name="54"><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>, @@ -1130,7 +1183,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="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> +<dt><a name="55"><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 @@ -1144,7 +1197,15 @@ 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="50"><i class='arg'>pathName</i> <b class='cmd'>item create</b> ?<i class='arg'>option value ...</i>?</a><dd> +<dt><a name="56"><i class='arg'>pathName</i> <b class='cmd'>item count</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 +deleted by the <b class='cmd'>item delete</b> widget command, plus 1 for the ever-present +root item. + +<br><br> +<dt><a name="57"><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. @@ -1177,7 +1238,7 @@ and b) each ancestor's <strong>-visible</strong> option is true </dl> -<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> +<dt><a name="58"><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>. @@ -1195,14 +1256,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="52"><i class='arg'>pathName</i> <b class='cmd'>item dump</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="59"><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="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> +<dt><a name="60"><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 @@ -1211,7 +1272,7 @@ The following forms of the command are supported: <br><br> <dl> -<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> +<dt><a name="61"><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 @@ -1223,7 +1284,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="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> +<dt><a name="62"><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 @@ -1232,7 +1293,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="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> +<dt><a name="63"><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 @@ -1251,7 +1312,7 @@ 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="57"><i class='arg'>pathName</i> <b class='cmd'>item expand</b> <i class='arg'>itemDesc</i> ?<strong>-recurse</strong>?</a><dd> +<dt><a name="64"><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. @@ -1270,7 +1331,7 @@ 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> +<dt><a name="65"><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>. @@ -1279,29 +1340,26 @@ 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="59"><i class='arg'>pathName</i> <b class='cmd'>item index</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="66"><i class='arg'>pathName</i> <b class='cmd'>item id</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>, -if all items above are counted and if only the displayed items are counted. -This command should not be confused with the <b class='cmd'>index</b> widget command, -which return the invariable item id. -The index here is basically the row of the item. +This command resolves the item description <i class='arg'>itemDesc</i> into a unique item +identifier (see <a href="#itemdescription">ITEM DESCRIPTION</a> below). If the item described by +<i class='arg'>itemDesc</i> doesn't exist, this command returns an empty string. <br><br> -<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> +<dt><a name="67"><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="61"><i class='arg'>pathName</i> <b class='cmd'>item isopen</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="68"><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="62"><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="69"><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>. @@ -1310,7 +1368,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="63"><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="70"><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>. @@ -1319,18 +1377,29 @@ 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="64"><i class='arg'>pathName</i> <b class='cmd'>item numchildren</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="71"><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="65"><i class='arg'>pathName</i> <b class='cmd'>item parent</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="72"><i class='arg'>pathName</i> <b class='cmd'>item order</b> <i class='arg'>itemDesc</i> ?<i class='arg'>-visible</i>?</a><dd> + +This command returns the position of the item <i class='arg'>itemDesc</i> relative to +its toplevel ancestor (usually the root item, unless the ancestor is an +orphan). If you imagine all the items flattened into a vertical list, the +result of this command is the row the item falls in. If the optional argument +<i class='arg'>-visible</i> is given, only the items whose ancestors are expanded, and whose +-visible option is true, get counted; in this case -1 is returned if the item +is not visible. + +<br><br> +<dt><a name="73"><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="66"><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="74"><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>. @@ -1339,19 +1408,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="67"><i class='arg'>pathName</i> <b class='cmd'>item remove</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="75"><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="68"><i class='arg'>pathName</i> <b class='cmd'>item rnc</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="76"><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="69"><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="77"><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. @@ -1364,7 +1433,7 @@ the order between these two limiting items doesn't matter. <br><br> The sort column can be specified by means of the <strong>-column</strong> option; -this option can be used repeatedly to define a multi column sort. +this option can be used repeatedly to define a multicolumn sort. The sorting is done by looking at the <i class='arg'>text</i> of the element specified by the <strong>-element</strong> option, which must be a text element defined in the style of the sorting column, @@ -1422,7 +1491,7 @@ Convert to integers and use integer comparison. Convert to floating-point values and use floating comparison. </dl> -<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> +<dt><a name="78"><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 @@ -1432,13 +1501,13 @@ The following forms of the command are supported: <br><br> <dl> -<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> +<dt><a name="79"><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="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> +<dt><a name="80"><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 @@ -1448,7 +1517,7 @@ If a <i class='arg'>stateName</i> is specified, 0 otherwise. <br><br> -<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> +<dt><a name="81"><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), @@ -1464,7 +1533,7 @@ then the state changes are made for all items of the treectrl widget. </dl> -<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> +<dt><a name="82"><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 @@ -1473,14 +1542,14 @@ The following forms of the command are supported: <br><br> <dl> -<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> +<dt><a name="83"><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="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> +<dt><a name="84"><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 @@ -1493,7 +1562,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="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> +<dt><a name="85"><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>. @@ -1505,7 +1574,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="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> +<dt><a name="86"><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 @@ -1518,7 +1587,7 @@ this command is provided as a convenience. Use the 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> +<dt><a name="87"><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, @@ -1531,7 +1600,7 @@ If <strong>-recurse</strong> is specified, the state of all descendants of </dl> -<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> +<dt><a name="88"><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 @@ -1548,7 +1617,7 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="81"><i class='arg'>pathName</i> <b class='cmd'>marquee anchor</b> ?<i class='arg'>x y</i>?</a><dd> +<dt><a name="89"><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. @@ -1556,7 +1625,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="82"><i class='arg'>pathName</i> <b class='cmd'>marquee cget</b> <i class='arg'>option</i></a><dd> +<dt><a name="90"><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>. @@ -1564,7 +1633,7 @@ named <i class='arg'>option</i>. <b class='cmd'>marquee configure</b> widget command. <br><br> -<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> +<dt><a name="91"><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 @@ -1591,7 +1660,7 @@ whether the dotted line surrounding the region of the marquee should currently be visible. </dl> -<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> +<dt><a name="92"><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, @@ -1601,7 +1670,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="85"><i class='arg'>pathName</i> <b class='cmd'>marquee corner</b> ?<i class='arg'>x y</i>?</a><dd> +<dt><a name="93"><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. @@ -1609,7 +1678,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="86"><i class='arg'>pathName</i> <b class='cmd'>marquee identify</b></a><dd> +<dt><a name="94"><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 @@ -1623,7 +1692,7 @@ if there are any. </dl> -<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> +<dt><a name="95"><i class='arg'>pathName</i> <b class='cmd'>notify</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a><dd> Many Tk widgets communicate with the outside world via <strong>-command</strong> callbacks and/or virtual events. For example, the Text widget @@ -1639,7 +1708,7 @@ The following forms of the command are supported: <br><br> <dl> -<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> +<dt><a name="96"><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 Tcl scripts with events generated by a treectrl widget. @@ -1668,7 +1737,7 @@ for a window; otherwise it may be an arbitrary string. Unlike the regular that window is destroyed. <br><br> -<dt><a name="89"><i class='arg'>pathName</i> <b class='cmd'>notify configure</b> <i class='arg'>object</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="97"><i class='arg'>pathName</i> <b class='cmd'>notify configure</b> <i class='arg'>object</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 sets and retrieves options for bindings created by the <b class='cmd'>notify bind</b> command. @@ -1693,7 +1762,7 @@ a binding script will not be evaluated when the corresponding event is generated. </dl> -<dt><a name="90"><i class='arg'>pathName</i> <b class='cmd'>notify detailnames</b> <i class='arg'>eventName</i></a><dd> +<dt><a name="98"><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> @@ -1701,14 +1770,14 @@ by means of the <b class='cmd'>notify install</b> widget command or by the treectrl widget itself. <br><br> -<dt><a name="91"><i class='arg'>pathName</i> <b class='cmd'>notify eventnames</b></a><dd> +<dt><a name="99"><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</b> widget command or by the treectrl widget itself. <br><br> -<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>? ?<i class='arg'>percentsCommand</i>?</a><dd> +<dt><a name="100"><i class='arg'>pathName</i> <b class='cmd'>notify generate</b> <i class='arg'>pattern</i> ?<i class='arg'>charMap</i>? ?<i class='arg'>percentsCommand</i>?</a><dd> This command causes the treectrl widget to generate an event. This command is typically used to generate dynamic events created by the <b class='cmd'>notify install</b> @@ -1734,7 +1803,7 @@ command is available, then all %-substitution is done using <i class='arg'>charM See <b class='cmd'>notify install</b> for a description of <i class='arg'>percentsCommand</i>. <br><br> -<dt><a name="93"><i class='arg'>pathName</i> <b class='cmd'>notify install</b> <i class='arg'>pattern</i> ?<i class='arg'>percentsCommand</i>?</a><dd> +<dt><a name="101"><i class='arg'>pathName</i> <b class='cmd'>notify install</b> <i class='arg'>pattern</i> ?<i class='arg'>percentsCommand</i>?</a><dd> This command installs a new event or detail specified by <i class='arg'>pattern</i>. Events created by this command are called dynamic, @@ -1769,19 +1838,19 @@ by itself. or an error if the event is not dynamic. <br><br> -<dt><a name="94"><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="102"><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> This command is for backward compatibility only. Use <b class='cmd'>notify install</b> with a <i class='arg'>pattern</i> of <<i class='arg'>eventName</i>-<i class='arg'>detail</i>> instead. <br><br> -<dt><a name="95"><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="103"><i class='arg'>pathName</i> <b class='cmd'>notify install event</b> <i class='arg'>eventName</i> ?<i class='arg'>percentsCommand</i>?</a><dd> This command is for backward compatibility only. Use <b class='cmd'>notify install</b> with a <i class='arg'>pattern</i> of <<i class='arg'>eventName</i>> instead. <br><br> -<dt><a name="96"><i class='arg'>pathName</i> <b class='cmd'>notify linkage</b> <i class='arg'>pattern</i></a><dd> +<dt><a name="104"><i class='arg'>pathName</i> <b class='cmd'>notify linkage</b> <i class='arg'>pattern</i></a><dd> Returns a string indicating whether the specified event or detail is created @@ -1789,51 +1858,43 @@ 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="97"><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="105"><i class='arg'>pathName</i> <b class='cmd'>notify linkage</b> <i class='arg'>eventName</i> ?<i class='arg'>detail</i>?</a><dd> This form of this command is for backward compatibility only. Use <b class='cmd'>notify linkage</b> with a <i class='arg'>pattern</i> of <<i class='arg'>eventName</i>> or <<i class='arg'>eventName</i>-<i class='arg'>detail</i>> instead. <br><br> -<dt><a name="98"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall</b> <i class='arg'>pattern</i></a><dd> +<dt><a name="106"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall</b> <i class='arg'>pattern</i></a><dd> If the event or detail specified by <i class='arg'>pattern</i> is static (i.e. created by the treectrl widget itself), an error is generated. Otherwise the dynamic event or detail is removed. <br><br> -<dt><a name="99"><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="107"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall detail</b> <i class='arg'>eventName</i> <i class='arg'>detail</i></a><dd> This command is for backward compatibility only. Use <b class='cmd'>notify uninstall</b> with a <i class='arg'>pattern</i> of <<i class='arg'>eventName</i>-<i class='arg'>detail</i>> instead. <br><br> -<dt><a name="100"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall event</b> <i class='arg'>eventName</i></a><dd> +<dt><a name="108"><i class='arg'>pathName</i> <b class='cmd'>notify uninstall event</b> <i class='arg'>eventName</i></a><dd> This command is for backward compatibility only. Use <b class='cmd'>notify uninstall</b> with a <i class='arg'>pattern</i> of <<i class='arg'>eventName</i>> instead. </dl> -<dt><a name="101"><i class='arg'>pathName</i> <b class='cmd'>numcolumns</b></a><dd> +<dt><a name="109"><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 -deleted by the <b class='cmd'>column delete</b> widget command. The <strong>tail</strong> column -is not counted. +Deprecated. Use the <b class='cmd'>column count</b> command instead. <br><br> -<dt><a name="102"><i class='arg'>pathName</i> <b class='cmd'>numitems</b></a><dd> +<dt><a name="110"><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 -deleted by the <b class='cmd'>item delete</b> widget command. -This number is always positive, -since a newly created treectrl widget has already the root item, -which cannot be deleted. +Deprecated. Use the <b class='cmd'>item count</b> command instead. <br><br> -<dt><a name="103"><i class='arg'>pathName</i> <b class='cmd'>orphans</b></a><dd> +<dt><a name="111"><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. @@ -1842,7 +1903,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="104"><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="112"><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 @@ -1851,7 +1912,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="105"><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="113"><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. @@ -1861,13 +1922,13 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="106"><i class='arg'>pathName</i> <b class='cmd'>state define</b> <i class='arg'>stateName</i></a><dd> +<dt><a name="114"><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="107"><i class='arg'>pathName</i> <b class='cmd'>state linkage</b> <i class='arg'>stateName</i></a><dd> +<dt><a name="115"><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 @@ -1875,18 +1936,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="108"><i class='arg'>pathName</i> <b class='cmd'>state names</b></a><dd> +<dt><a name="116"><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="109"><i class='arg'>pathName</i> <b class='cmd'>state undefine</b> ?<i class='arg'>stateName ...</i>?</a><dd> +<dt><a name="117"><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="110"><i class='arg'>pathName</i> <b class='cmd'>see</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="118"><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. @@ -1896,14 +1957,14 @@ and the corresponding <strong><Scroll-x></strong> and/or <strong><Scrol events are generated. <br><br> -<dt><a name="111"><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="119"><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="112"><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="120"><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>. @@ -1915,7 +1976,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="113"><i class='arg'>pathName</i> <b class='cmd'>selection anchor</b> ?<i class='arg'>itemDesc</i>?</a><dd> +<dt><a name="121"><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. @@ -1926,7 +1987,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="114"><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="122"><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>. @@ -1939,13 +2000,13 @@ the selection is completely cleared instead. A <strong><Selection></strong> event is generated. <br><br> -<dt><a name="115"><i class='arg'>pathName</i> <b class='cmd'>selection count</b></a><dd> +<dt><a name="123"><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="116"><i class='arg'>pathName</i> <b class='cmd'>selection get</b></a><dd> +<dt><a name="124"><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. @@ -1953,13 +2014,13 @@ If there are no items selected in the treectrl then an empty string is returned. <br><br> -<dt><a name="117"><i class='arg'>pathName</i> <b class='cmd'>selection includes</b> <i class='arg'>itemDesc</i></a><dd> +<dt><a name="125"><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="118"><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="126"><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. @@ -1972,7 +2033,7 @@ it is added to the selection. A <strong><Selection></strong> event is generated. </dl> -<dt><a name="119"><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="127"><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. @@ -1982,7 +2043,7 @@ The following forms of the command are supported: <br><br> <dl> -<dt><a name="120"><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="128"><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>. @@ -1990,7 +2051,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="121"><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="129"><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> @@ -2019,7 +2080,7 @@ Must be either <strong>horizontal</strong> (the default) or <strong>vertical</strong> or an abbreviation of one of these. </dl> -<dt><a name="122"><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="130"><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> @@ -2030,7 +2091,7 @@ configuration. Returns the name of the new style. <br><br> -<dt><a name="123"><i class='arg'>pathName</i> <b class='cmd'>style delete</b> ?<i class='arg'>style ...</i>?</a><dd> +<dt><a name="131"><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 @@ -2038,7 +2099,7 @@ one or more items, it is also removed from the style list of these items. <br><br> -<dt><a name="124"><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="132"><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 @@ -2053,7 +2114,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="125"><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="133"><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> @@ -2123,17 +2184,17 @@ Specifies whether the element should be positioned by themselves, i.e. independent from the other elements. </dl> -<dt><a name="126"><i class='arg'>pathName</i> <b class='cmd'>style names</b></a><dd> +<dt><a name="134"><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="127"><i class='arg'>pathName</i> <b class='cmd'>toggle</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a><dd> +<dt><a name="135"><i class='arg'>pathName</i> <b class='cmd'>toggle</b> ?<strong>-recurse</strong>? ?<i class='arg'>itemDesc ...</i>?</a><dd> Use <b class='cmd'>item toggle</b> instead. <br><br> -<dt><a name="128"><i class='arg'>pathName</i> <b class='cmd'>xview</b> ?<i class='arg'>args</i>?</a><dd> +<dt><a name="136"><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. @@ -2141,7 +2202,7 @@ It can take any of the following forms: <br><br> <dl> -<dt><a name="129"><i class='arg'>pathName</i> <b class='cmd'>xview</b></a><dd> +<dt><a name="137"><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 @@ -2154,7 +2215,7 @@ These are the same values passed to scrollbars via the <strong>-xscrollcommand</ option. <br><br> -<dt><a name="130"><i class='arg'>pathName</i> <b class='cmd'>xview moveto</b> <i class='arg'>fraction</i></a><dd> +<dt><a name="138"><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. @@ -2162,7 +2223,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="131"><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="139"><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>. @@ -2180,7 +2241,7 @@ becomes visible. A <strong><Scroll-x></strong> event is generated. </dl> -<dt><a name="132"><i class='arg'>pathName</i> <b class='cmd'>yview</b> ?<i class='arg'>args</i>?</a><dd> +<dt><a name="140"><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. @@ -2188,7 +2249,7 @@ It can take any of the following forms: <br><br> <dl> -<dt><a name="133"><i class='arg'>pathName</i> <b class='cmd'>yview</b></a><dd> +<dt><a name="141"><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 @@ -2199,7 +2260,7 @@ These are the same values passed to scrollbars via the <strong>-yscrollcommand</ option. <br><br> -<dt><a name="134"><i class='arg'>pathName</i> <b class='cmd'>yview moveto</b> <i class='arg'>fraction</i></a><dd> +<dt><a name="142"><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. @@ -2207,7 +2268,7 @@ area is off-screen to the top. A <strong><Scroll-y></strong> event is generated. <br><br> -<dt><a name="135"><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="143"><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>. @@ -2232,11 +2293,8 @@ other. An item can be considered as a row, which reaches over all columns. <p> -Columns in a treectrl may be named in either of two ways: by number or by tag. -If a number is given it must be an integer from zero to <i class='arg'>N</i>, where <i class='arg'>N</i> -is one less than the result of the <b class='cmd'>numcolumns</b> widget command. -A column may also be named by the value of its <strong>-tag</strong> configuration -option. +Columns in a treectrl may be specified in a number of ways. +See <a href="#columndescription">COLUMN DESCRIPTION</a> below. <p> There is always one special column, the <strong>tail</strong> column, which fills @@ -2263,12 +2321,12 @@ to the right of the column title. <br><br> <dt><strong><strong>-arrowbitmap</strong></strong> <i class='arg'>bitmap</i><dd> Specifies as a per-state option the bitmap to use to draw the arrow if -this columns -arrow option is not <strong>none</strong>. +this column's -arrow option is not <strong>none</strong>. <br><br> <dt><strong><strong>-arrowimage</strong></strong> <i class='arg'>image</i><dd> Specifies as a per-state option the image to use to draw the arrow if -this columns -arrow option is not <strong>none</strong>. If an image is specified for +this column's -arrow option is not <strong>none</strong>. If an image is specified for a certain state, it overrides the -arrowbitmap option. <br><br> @@ -2454,6 +2512,68 @@ d) and the tree <strong>-wrap</strong> option results in wrapping. </dl> +<h2><a name="columndescription">COLUMN DESCRIPTION</a></h2> +<p> +Many of the commands and options for a treectrl take as an argument a +description of which column to operate on. +See the <a href="#examples">EXAMPLES</a> section for examples. +The initial part of a column description must begin with one of the following terms: + +<dl> +<dt><i class='arg'>id</i><dd> +Specifies the unique column identifier, where <i class='arg'>id</i> should be +the return value of a prior call of the <b class='cmd'>column create</b> widget command. + +<br><br> +<dt><i class='arg'>tag</i><dd> +Specifies the value of a column's -tag option. + +<br><br> +<dt><strong>all</strong><dd> +Indicates every column, including the tail column. Not all commands accept this. + +<br><br> +<dt><strong>first</strong> ?<strong>visible</strong>?<dd> +Indicates the leftmost column of the treectrl. +If <strong>visible</strong> is specified, the leftmost column whose -visible option +is true is used. + +<br><br> +<dt><strong>last</strong> ?<strong>visible</strong>?<dd> +Indicates the rightmost column of the treectrl (but not the tail column). +If <strong>visible</strong> is specified, the rightmost column whose -visible option +is true is used. + +<br><br> +<dt><strong>order</strong> <i class='arg'>n</i> ?<strong>visible</strong>?<dd> +Indicates the <i class='arg'>n</i>th column in the list of columns as returned by the +<b class='cmd'>column order</b> command. + +<br><br> +<dt><strong>tail</strong><dd> +Indicates the ever-present tail column of the treectrl. +</dl> + +<p> +The initial part of the column description (matching any of the values above) +may be followed by one or more <i class='arg'>modifier</i>s. +A modifier changes the column used relative to +the description up to this point. +It may be specified in any of the following forms: + +<dl> + +<dt><strong>next</strong> ?<strong>visible</strong>?<dd> +Use the column to the right, or the column to the right whose -visible option +is true. + +<br><br> +<dt><strong>prev</strong> ?<strong>visible</strong>?<dd> +Use the column to the left, or the column to the left whose -visible option +is true. + +</dl> + <h2><a name="states">STATES</a></h2> <p> A state consists basically of just a string: its <i class='arg'>stateName</i>. @@ -2536,7 +2656,7 @@ However, to use a different font when the item is selected you could write: <p><table><tr><td bgcolor=black> </td><td><pre class='sample'> $T element configure MyTextElement -font {{Courier 10} selected {Times 12 bold} {}} </pre></td></tr></table></p> -In the second example above the -font option reads "value stateList value stateList". +In the example above, the -font option reads "value stateList value stateList". If <i class='arg'>stateList</i> is an empty list, the preceding <i class='arg'>value</i> is used regardless of the item state. A non-empty stateList specifies a list of states which must be set for the item in order to use the preceding value. Each stateList can also @@ -2795,16 +2915,16 @@ with a particular item. <h2><a name="itemdescription">ITEM DESCRIPTION</a></h2> <p> -Many of the widget commands for a treectrl take as one argument an -indicator of which item of the treectrl to operate on. These -indicators are called <i class='arg'>itemDesc</i>s and may be specified in -any of the following forms: +Many of the commands and options for a treectrl take as an argument a +description of which item to operate on. +See the <a href="#examples">EXAMPLES</a> section for examples. +The initial part of an item description must begin with one of the following terms: <dl> -<dt><i class='arg'>number</i><dd> -Specifies the item numerically, where <i class='arg'>number</i> should be +<dt><i class='arg'>id</i><dd> +Specifies the unique item identifier, where <i class='arg'>id</i> should be the return value of a prior call of the <b class='cmd'>item create</b> widget command, -or <strong>0</strong> to specify the root item. +or <strong>0</strong> to specify the ever-present root item. <br><br> <dt><strong>active</strong><dd> @@ -2847,8 +2967,9 @@ Indicates the root item of the treectrl. </dl> <p> -The <i class='arg'>itemDesc</i> may be followed by one or more <i class='arg'>modifier</i>s. -A modifier changes the item described by the <i class='arg'>itemDesc</i> relative to +The initial part of the column description (matching any of the values above) +may be followed by one or more <i class='arg'>modifier</i>s. +A modifier changes the item used relative to the description up to this point. It may be specified in any of the following forms: @@ -3145,6 +3266,41 @@ depending on the direction, the wheel was turned. The active cursor or the selection is not affected. </ol> +<h2><a name="examples">EXAMPLES</a></h2> +<p> + +Get the unique identifier for the leftmost visible column: +<p><table><tr><td bgcolor=black> </td><td><pre class='sample'> +set id [$T column index "first visible"] +</pre></td></tr></table></p> + +Delete the leftmost column: +<p><table><tr><td bgcolor=black> </td><td><pre class='sample'> +$T column delete "order 0" +</pre></td></tr></table></p> + +Take the visible column that is to the left of the last column, and move that +column in front of the tail column: +<p><table><tr><td bgcolor=black> </td><td><pre class='sample'> +$T column move "last prev visible" tail +</pre></td></tr></table></p> + + +Get the unique identifier for the first visible item: +<p><table><tr><td bgcolor=black> </td><td><pre class='sample'> +set id [$T item index "first visible"] +</pre></td></tr></table></p> + +Delete the parent of the item that is under the point x,y: +<p><table><tr><td bgcolor=black> </td><td><pre class='sample'> +$T item delete "nearest $x $y parent" +</pre></td></tr></table></p> + +Add the 10th child of the second child of the root item to the selection: +<p><table><tr><td bgcolor=black> </td><td><pre class='sample'> +$T selection add "root firstchild nextsibling child 10" +</pre></td></tr></table></p> + <h2><a name="seealso">SEE ALSO</a></h2> |