diff options
| author | treectrl <treectrl> | 2005-05-13 20:50:19 (GMT) |
|---|---|---|
| committer | treectrl <treectrl> | 2005-05-13 20:50:19 (GMT) |
| commit | 94b54ef71ef6c2725d84a19c2c28d1ed085801fa (patch) | |
| tree | e57b1580e6c49bdbb415ca1f7b4eb37bcf2d188a | |
| parent | 7160cf548d9ee1d2ad9431aac3e11cf43ea3cbae (diff) | |
| download | tktreectrl-94b54ef71ef6c2725d84a19c2c28d1ed085801fa.zip tktreectrl-94b54ef71ef6c2725d84a19c2c28d1ed085801fa.tar.gz tktreectrl-94b54ef71ef6c2725d84a19c2c28d1ed085801fa.tar.bz2 | |
Bump version to 2.0 because of API changes.
New "column configure all" syntax.
New "column compare" command.
Return value of "column create" is unique identifier.
New "column delete all" syntax.
Deprecated "column index".
New command "column id".
New command "column list".
New command "column order".
Deprecated "compare".
Deprecated "index".
New command "item compare".
New command "item count".
New command "item id".
New command "item order" (replaces old "item index").
Deprecated "numcolumns" and "numitems".
Added section COLUMN DESCRIPTION.
Added section EXAMPLES with examples of column/item descriptions.
| -rw-r--r-- | doc/treectrl.html | 768 | ||||
| -rw-r--r-- | doc/treectrl.man | 229 | ||||
| -rw-r--r-- | doc/treectrl.n | 237 |
3 files changed, 818 insertions, 416 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> diff --git a/doc/treectrl.man b/doc/treectrl.man index b1a0bef..8b2bcf1 100644 --- a/doc/treectrl.man +++ b/doc/treectrl.man @@ -3,11 +3,11 @@ See the file "license.terms" for information on usage and redistribution of this file, and for a DISCLAIMER OF ALL WARRANTIES. - $Id: treectrl.man,v 1.13 2005/05/11 03:31:32 treectrl Exp $} -][manpage_begin treectrl n 1.2] + $Id: treectrl.man,v 1.14 2005/05/13 20:50:20 treectrl Exp $} +][manpage_begin treectrl n 2.0] [moddesc {Tk Commands}] [titledesc {Create and manipulate hierarchical multicolumn widgets}] -[require treectrl 1.2] +[require treectrl 2.0] [description] [list_begin definitions] @@ -378,7 +378,9 @@ for the column specified by [arg column], This command is similar to the [cmd configure] widget command except that it modifies options associated with the column specified by [arg column] instead of modifying options for the overall treectrl widget. -[arg Column] may also be the string [const tail] to specify the tail column. +[arg Column] may be the string [const tail] to specify the tail column. +If [arg column] is the string [const all], at least one option-value pair +must be given; in this case all the columns are configured. If no [arg option] is specified, the command returns a list describing all of the available options for [arg column] (see [fun Tk_ConfigureInfo] for information on the format of this list). @@ -393,22 +395,45 @@ in this case the command returns an empty string. See [sectref COLUMNS] below for details on the options available for columns. +[call [arg pathName] [cmd {column compare}] [arg column1] [arg op] [arg column2]] +From both [arg column]s the index is retrieved +(as returned from the [cmd {column order}] widget command). +Then these indexes are compared using the operator [arg op], which must +be either [const <], [const <=], [const ==], [const >=], [const >], +or [const !=]. +The return value of this command is 1 if the comparison evaluated to true, +0 otherwise. + +[call [arg pathName] [cmd {column count}]] +Returns a decimal string giving the number of +columns created by the [cmd "column create"] widget command which haven't been +deleted by the [cmd "column delete"] widget command. The [const tail] column +is not counted. + [call [arg pathName] [cmd {column create}] [opt [arg {option value ...}]]] This command creates a new column in the treectrl widget. The new column is placed to the right of all other columns (except the [const tail] column). Any [arg option]-[arg value] arguments configure the new column according to the -[cmd "column configure"] command. The return value is the zero-based index +[cmd "column configure"] command. The return value is the unique identifier of the new column. [call [arg pathName] [cmd {column delete}] [arg column]] -Deletes the specified [arg column] 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 [arg column] from the treectrl widget. If [arg column] +is the string [const all], all columns except the tail column are deleted. [call [arg pathName] [cmd {column index}] [arg column]] -This command returns a decimal string giving the column number -of the column specified by [arg column], -which may also be the string [const tail] to specify the tail column. +Deprecated. Use [cmd {column id}] + +[call [arg pathName] [cmd {column id}] [arg column]] +This command resolves the column description [arg column] into a unique column +identifier (see [sectref {COLUMN DESCRIPTION}] below). +If the column described by [arg column] doesn't exist, this command returns +an empty string. + +[call [arg pathName] [cmd {column list}] [opt [arg -visible]]] +This command returns a list of identifiers for every column (except the tail) +from left to right. If [arg -visible] is given, only columns whose -visible +option is true are returned. [call [arg pathName] [cmd {column move}] [arg column] [arg before]] Moves the specified [arg column] to the left of the column @@ -422,6 +447,13 @@ of the column specified by [arg column]. The needed width is the maximum of the width of the column header and the width of the [emph widest] currently visible item. +[call [arg pathName] [cmd {column order}] [arg column] [opt [arg -visible]]] +This command returns a decimal string giving the position of [arg column] +in the list of columns starting from zero for the leftmost column. +If [arg -visible] is given, only columns whose -visible +option is true are considered, and -1 is returned if [arg column]'s -visible +option is false. + [call [arg pathName] [cmd {column width}] [arg column]] This command returns a decimal string giving the width in pixels of the column specified by [arg column], @@ -430,13 +462,7 @@ by means of the [option -showheader] option. [list_end] [call [arg pathName] [cmd compare] [arg itemDesc1] [arg op] [arg itemDesc2]] -From both items described by the [arg itemDesc]s the index is retrieved -(as returned from the [cmd {item index}] widget command). -Then these indexes are compared using the operator [arg op], which must -be either [const <], [const <=], [const ==], [const >=], [const >], -or [const !=]. -The return value of this command is 1 if the comparison evaulated to true, -0 otherwise. +Deprecated. Use the [cmd {item compare}] command instead. [call [arg pathName] [cmd configure] [opt [arg option]] \ [opt [arg {value option value ...}]]] @@ -702,9 +728,7 @@ if the x coordinate is to the right of the elements; nothing otherwise. [call [arg pathName] [cmd index] [arg itemDesc]] -This command returns a decimal string giving the numerical id -of the item specified by [arg itemDesc] -(see [sectref {ITEM DESCRIPTION}] below). +Deprecated. Use [cmd {item id}] instead. [call [arg pathName] [cmd item] [arg option] [opt [arg {arg ...}]]] This command is used to manipulate items. @@ -756,6 +780,15 @@ two events are generated: a [const <Collapse-before>] event before the item state is changed, and a [const <Collapse-after>] event after the item state was changed. +[call [arg pathName] [cmd {item compare}] [arg itemDesc1] [arg op] [arg itemDesc2]] +From both items described by the [arg itemDesc]s the index is retrieved +(as returned from the [cmd {item order}] widget command). +Then these indexes are compared using the operator [arg op], which must +be either [const <], [const <=], [const ==], [const >=], [const >], +or [const !=]. +The return value of this command is 1 if the comparison evaluated to true, +0 otherwise. + [call [arg pathName] [cmd {item complex}] [arg itemDesc] [arg list] [arg ...]] Modifies the elements of the item described by [arg itemDesc]. For every column of the treectrl there may be specified one [arg list], @@ -778,6 +811,12 @@ given value(s); in this case the command returns an empty string. The options and values are the same as those permissible in the [cmd "item create"] command when the item was created. +[call [arg pathName] [cmd {item count}]] +Returns a decimal string giving the number of +items created by the [cmd "item create"] widget command which haven't been +deleted by the [cmd "item delete"] widget command, plus 1 for the ever-present +root item. + [call [arg pathName] [cmd {item create}] [opt [arg {option value ...}]]] Creates a new item and returns its unique identifier. The new item has the states [const open] and [const enabled] set by default. @@ -900,13 +939,10 @@ If [arg child] is specified, it must described an item that is not an ancestor of [arg parent]. Then it will become the new first child of [arg parent]. -[call [arg pathName] [cmd {item index}] [arg itemDesc]] -Returns a list of two integers, which corresponds to the row -of the item described by [arg itemDesc], -if all items above are counted and if only the displayed items are counted. -This command should not be confused with the [cmd index] widget command, -which return the invariable item id. -The index here is basically the row of the item. +[call [arg pathName] [cmd {item id}] [arg itemDesc]] +This command resolves the item description [arg itemDesc] into a unique item +identifier (see [sectref {ITEM DESCRIPTION}] below). If the item described by +[arg itemDesc] doesn't exist, this command returns an empty string. [call [arg pathName] [cmd {item isancestor}] [arg itemDesc] [arg descendant]] Returns 1 if the item described by [arg itemDesc] is a direct or indirect @@ -933,6 +969,15 @@ Then it will become the new next sibling of [arg sibling]. [call [arg pathName] [cmd {item numchildren}] [arg itemDesc]] Returns the number of children of the item described by [arg itemDesc]. +[call [arg pathName] [cmd {item order}] [arg itemDesc] [opt [arg -visible]]] +This command returns the position of the item [arg itemDesc] 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 +[arg -visible] 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. + [call [arg pathName] [cmd {item parent}] [arg itemDesc]] Returns the numerical index of the parent of the item described by [arg itemDesc]. @@ -964,7 +1009,7 @@ the order between these two limiting items doesn't matter. [nl] The sort column can be specified by means of the [option -column] 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 [arg text] of the element specified by the [option -element] option, which must be a text element defined in the style of the sorting column, @@ -1368,18 +1413,10 @@ Use [cmd {notify uninstall}] with a [arg pattern] of <[arg eventName]> instead. [list_end] [call [arg pathName] [cmd numcolumns]] -Returns a decimal string giving the number of -columns created by the [cmd "column create"] widget command which haven't been -deleted by the [cmd "column delete"] widget command. The [const tail] column -is not counted. +Deprecated. Use the [cmd {column count}] command instead. [call [arg pathName] [cmd numitems]] -Returns a decimal string giving the number of -items created by the [cmd "item create"] widget command which haven't been -deleted by the [cmd "item delete"] 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 [cmd {item count}] command instead. [call [arg pathName] [cmd orphans]] Returns a list containing the numerical ids of all items @@ -1720,11 +1757,8 @@ other. An item can be considered as a row, which reaches over all columns. [para] -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 [arg N], where [arg N] -is one less than the result of the [cmd numcolumns] widget command. -A column may also be named by the value of its [option -tag] configuration -option. +Columns in a treectrl may be specified in a number of ways. +See [sectref {COLUMN DESCRIPTION}] below. [para] There is always one special column, the [const tail] column, which fills @@ -1912,6 +1946,60 @@ d) and the tree [option -wrap] option results in wrapping. [list_end] +[section {COLUMN DESCRIPTION}] +Many of the commands and options for a treectrl take as an argument a +description of which column to operate on. +See the [sectref EXAMPLES] section for examples. +The initial part of a column description must begin with one of the following terms: + +[list_begin definitions] +[lst_item [arg id]] +Specifies the unique column identifier, where [arg id] should be +the return value of a prior call of the [cmd {column create}] widget command. + +[lst_item [arg tag]] +Specifies the value of a column's -tag option. + +[lst_item [const all]] +Indicates every column, including the tail column. Not all commands accept this. + +[lst_item "[const first] [opt [const visible]]"] +Indicates the leftmost column of the treectrl. +If [const visible] is specified, the leftmost column whose -visible option +is true is used. + +[lst_item "[const last] [opt [const visible]]"] +Indicates the rightmost column of the treectrl (but not the tail column). +If [const visible] is specified, the rightmost column whose -visible option +is true is used. + +[lst_item "[const order] [arg n] [opt [const visible]]"] +Indicates the [arg n]th column in the list of columns as returned by the +[cmd {column order}] command. + +[lst_item [const tail]] +Indicates the ever-present tail column of the treectrl. +[list_end] + +[para] +The initial part of the column description (matching any of the values above) +may be followed by one or more [arg modifier]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: + +[list_begin definitions] + +[lst_item "[const next] [opt [const visible]]"] +Use the column to the right, or the column to the right whose -visible option +is true. + +[lst_item "[const prev] [opt [const visible]]"] +Use the column to the left, or the column to the left whose -visible option +is true. + +[list_end] + [section STATES] A state consists basically of just a string: its [arg stateName]. For every item a set of these states is managed, @@ -2215,16 +2303,16 @@ with a particular item. [list_end] [section {ITEM DESCRIPTION}] -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 [arg itemDesc]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 [sectref EXAMPLES] section for examples. +The initial part of an item description must begin with one of the following terms: [list_begin definitions] -[lst_item [arg number]] -Specifies the item numerically, where [arg number] should be +[lst_item [arg id]] +Specifies the unique item identifier, where [arg id] should be the return value of a prior call of the [cmd {item create}] widget command, -or [const 0] to specify the root item. +or [const 0] to specify the ever-present root item. [lst_item [const active]] Indicates the item that is currently active, i.e. normally @@ -2260,8 +2348,9 @@ Indicates the root item of the treectrl. [list_end] [para] -The [arg itemDesc] may be followed by one or more [arg modifier]s. -A modifier changes the item described by the [arg itemDesc] relative to +The initial part of the item description (matching any of the values above) +may be followed by one or more [arg modifier]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: @@ -2506,6 +2595,40 @@ depending on the direction, the wheel was turned. The active cursor or the selection is not affected. [list_end] +[section EXAMPLES] + +Get the unique identifier for the leftmost visible column: +[example_begin] +set id [lb]$T column index "first visible"[rb] +[example_end] + +Delete the leftmost column: +[example_begin] +$T column delete "order 0" +[example_end] + +Take the visible column that is to the left of the last column, and move that +column in front of the tail column: +[example_begin] +$T column move "last prev visible" tail +[example_end] + + +Get the unique identifier for the first visible item: +[example_begin] +set id [lb]$T item index "first visible"[rb] +[example_end] + +Delete the parent of the item that is under the point x,y: +[example_begin] +$T item delete "nearest $x $y parent" +[example_end] + +Add the 10th child of the second child of the root item to the selection: +[example_begin] +$T selection add "root firstchild nextsibling child 10" +[example_end] + [see_also listbox(n) image(n) bitmap(n) bind(n) options(n)] [keywords tree widget] [manpage_end] diff --git a/doc/treectrl.n b/doc/treectrl.n index 0ed1b33..897de51 100644 --- a/doc/treectrl.n +++ b/doc/treectrl.n @@ -6,14 +6,14 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" $Id: treectrl.n,v 1.29 2005/05/11 03:31:33 treectrl Exp $ +'\" $Id: treectrl.n,v 1.30 2005/05/13 20:50:20 treectrl Exp $ .so man.macros -.TH "treectrl" n 1.2 "Tk Commands" +.TH "treectrl" n 2.0 "Tk Commands" .BS .SH "NAME" treectrl \- Create and manipulate hierarchical multicolumn widgets .SH "SYNOPSIS" -package require \fBtreectrl 1.2\fR +package require \fBtreectrl 2.0\fR .sp \fBtreectrl\fR \fIpathName\fR ?\fIoptions\fR?\fR .sp @@ -35,16 +35,26 @@ package require \fBtreectrl 1.2\fR .sp \fIpathName\fR \fBcolumn configure\fR \fIcolumn\fR ?\fIoption\fR? ?\fIvalue\fR? ?\fIoption value ...\fR?\fR .sp +\fIpathName\fR \fBcolumn compare\fR \fIcolumn1\fR \fIop\fR \fIcolumn2\fR\fR +.sp +\fIpathName\fR \fBcolumn count\fR\fR +.sp \fIpathName\fR \fBcolumn create\fR ?\fIoption value ...\fR?\fR .sp \fIpathName\fR \fBcolumn delete\fR \fIcolumn\fR\fR .sp \fIpathName\fR \fBcolumn index\fR \fIcolumn\fR\fR .sp +\fIpathName\fR \fBcolumn id\fR \fIcolumn\fR\fR +.sp +\fIpathName\fR \fBcolumn list\fR ?\fI-visible\fR?\fR +.sp \fIpathName\fR \fBcolumn move\fR \fIcolumn\fR \fIbefore\fR\fR .sp \fIpathName\fR \fBcolumn neededwidth\fR \fIcolumn\fR\fR .sp +\fIpathName\fR \fBcolumn order\fR \fIcolumn\fR ?\fI-visible\fR?\fR +.sp \fIpathName\fR \fBcolumn width\fR \fIcolumn\fR\fR .sp \fIpathName\fR \fBcompare\fR \fIitemDesc1\fR \fIop\fR \fIitemDesc2\fR\fR @@ -109,10 +119,14 @@ package require \fBtreectrl 1.2\fR .sp \fIpathName\fR \fBitem collapse\fR \fIitemDesc\fR ?\fB-recurse\fR?\fR .sp +\fIpathName\fR \fBitem compare\fR \fIitemDesc1\fR \fIop\fR \fIitemDesc2\fR\fR +.sp \fIpathName\fR \fBitem complex\fR \fIitemDesc\fR \fIlist\fR \fI...\fR\fR .sp \fIpathName\fR \fBitem configure\fR \fIitemDesc\fR ?\fIoption\fR? ?\fIvalue\fR? ?\fIoption value ...\fR?\fR .sp +\fIpathName\fR \fBitem count\fR\fR +.sp \fIpathName\fR \fBitem create\fR ?\fIoption value ...\fR?\fR .sp \fIpathName\fR \fBitem delete\fR \fIfirst\fR ?\fIlast\fR?\fR @@ -131,7 +145,7 @@ package require \fBtreectrl 1.2\fR .sp \fIpathName\fR \fBitem firstchild\fR \fIparent\fR ?\fIchild\fR?\fR .sp -\fIpathName\fR \fBitem index\fR \fIitemDesc\fR\fR +\fIpathName\fR \fBitem id\fR \fIitemDesc\fR\fR .sp \fIpathName\fR \fBitem isancestor\fR \fIitemDesc\fR \fIdescendant\fR\fR .sp @@ -143,6 +157,8 @@ package require \fBtreectrl 1.2\fR .sp \fIpathName\fR \fBitem numchildren\fR \fIitemDesc\fR\fR .sp +\fIpathName\fR \fBitem order\fR \fIitemDesc\fR ?\fI-visible\fR?\fR +.sp \fIpathName\fR \fBitem parent\fR \fIitemDesc\fR\fR .sp \fIpathName\fR \fBitem prevsibling\fR \fIsibling\fR ?\fIprev\fR?\fR @@ -848,7 +864,9 @@ for the column specified by \fIcolumn\fR, This command is similar to the \fBconfigure\fR widget command except that it modifies options associated with the column specified by \fIcolumn\fR instead of modifying options for the overall treectrl widget. -\fIColumn\fR may also be the string \fBtail\fR to specify the tail column. +\fIColumn\fR may be the string \fBtail\fR to specify the tail column. +If \fIcolumn\fR is the string \fBall\fR, at least one option-value pair +must be given; in this case all the columns are configured. If no \fIoption\fR is specified, the command returns a list describing all of the available options for \fIcolumn\fR (see \fBTk_ConfigureInfo\fR for information on the format of this list). @@ -862,22 +880,45 @@ in this case the command returns an empty string. .sp See \fBCOLUMNS\fR below for details on the options available for columns. .TP +\fIpathName\fR \fBcolumn compare\fR \fIcolumn1\fR \fIop\fR \fIcolumn2\fR\fR +From both \fIcolumn\fRs the index is retrieved +(as returned from the \fBcolumn order\fR widget command). +Then these indexes are compared using the operator \fIop\fR, which must +be either \fB<\fR, \fB<=\fR, \fB==\fR, \fB>=\fR, \fB>\fR, +or \fB!=\fR. +The return value of this command is 1 if the comparison evaluated to true, +0 otherwise. +.TP +\fIpathName\fR \fBcolumn count\fR\fR +Returns a decimal string giving the number of +columns created by the \fBcolumn create\fR widget command which haven't been +deleted by the \fBcolumn delete\fR widget command. The \fBtail\fR column +is not counted. +.TP \fIpathName\fR \fBcolumn create\fR ?\fIoption value ...\fR?\fR This command creates a new column in the treectrl widget. The new column is placed to the right of all other columns (except the \fBtail\fR column). Any \fIoption\fR-\fIvalue\fR arguments configure the new column according to the -\fBcolumn configure\fR command. The return value is the zero-based index +\fBcolumn configure\fR command. The return value is the unique identifier of the new column. .TP \fIpathName\fR \fBcolumn delete\fR \fIcolumn\fR\fR -Deletes the specified \fIcolumn\fR 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 \fIcolumn\fR from the treectrl widget. If \fIcolumn\fR +is the string \fBall\fR, all columns except the tail column are deleted. .TP \fIpathName\fR \fBcolumn index\fR \fIcolumn\fR\fR -This command returns a decimal string giving the column number -of the column specified by \fIcolumn\fR, -which may also be the string \fBtail\fR to specify the tail column. +Deprecated. Use \fBcolumn id\fR +.TP +\fIpathName\fR \fBcolumn id\fR \fIcolumn\fR\fR +This command resolves the column description \fIcolumn\fR into a unique column +identifier (see \fBCOLUMN DESCRIPTION\fR below). +If the column described by \fIcolumn\fR doesn't exist, this command returns +an empty string. +.TP +\fIpathName\fR \fBcolumn list\fR ?\fI-visible\fR?\fR +This command returns a list of identifiers for every column (except the tail) +from left to right. If \fI-visible\fR is given, only columns whose -visible +option is true are returned. .TP \fIpathName\fR \fBcolumn move\fR \fIcolumn\fR \fIbefore\fR\fR Moves the specified \fIcolumn\fR to the left of the column @@ -891,6 +932,13 @@ of the column specified by \fIcolumn\fR. The needed width is the maximum of the width of the column header and the width of the \fIwidest\fR currently visible item. .TP +\fIpathName\fR \fBcolumn order\fR \fIcolumn\fR ?\fI-visible\fR?\fR +This command returns a decimal string giving the position of \fIcolumn\fR +in the list of columns starting from zero for the leftmost column. +If \fI-visible\fR is given, only columns whose -visible +option is true are considered, and -1 is returned if \fIcolumn\fR's -visible +option is false. +.TP \fIpathName\fR \fBcolumn width\fR \fIcolumn\fR\fR This command returns a decimal string giving the width in pixels of the column specified by \fIcolumn\fR, @@ -899,13 +947,7 @@ by means of the \fB-showheader\fR option. .RE .TP \fIpathName\fR \fBcompare\fR \fIitemDesc1\fR \fIop\fR \fIitemDesc2\fR\fR -From both items described by the \fIitemDesc\fRs the index is retrieved -(as returned from the \fBitem index\fR widget command). -Then these indexes are compared using the operator \fIop\fR, which must -be either \fB<\fR, \fB<=\fR, \fB==\fR, \fB>=\fR, \fB>\fR, -or \fB!=\fR. -The return value of this command is 1 if the comparison evaulated to true, -0 otherwise. +Deprecated. Use the \fBitem compare\fR command instead. .TP \fIpathName\fR \fBconfigure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?\fR Query or modify the configuration options of the widget. @@ -1159,9 +1201,7 @@ if the x coordinate is to the right of the elements; nothing otherwise. .TP \fIpathName\fR \fBindex\fR \fIitemDesc\fR\fR -This command returns a decimal string giving the numerical id -of the item specified by \fIitemDesc\fR -(see \fBITEM DESCRIPTION\fR below). +Deprecated. Use \fBitem id\fR instead. .TP \fIpathName\fR \fBitem\fR \fIoption\fR ?\fIarg ...\fR?\fR This command is used to manipulate items. @@ -1212,6 +1252,15 @@ two events are generated: a \fB<Collapse-before>\fR event before the item state is changed, and a \fB<Collapse-after>\fR event after the item state was changed. .TP +\fIpathName\fR \fBitem compare\fR \fIitemDesc1\fR \fIop\fR \fIitemDesc2\fR\fR +From both items described by the \fIitemDesc\fRs the index is retrieved +(as returned from the \fBitem order\fR widget command). +Then these indexes are compared using the operator \fIop\fR, which must +be either \fB<\fR, \fB<=\fR, \fB==\fR, \fB>=\fR, \fB>\fR, +or \fB!=\fR. +The return value of this command is 1 if the comparison evaluated to true, +0 otherwise. +.TP \fIpathName\fR \fBitem complex\fR \fIitemDesc\fR \fIlist\fR \fI...\fR\fR Modifies the elements of the item described by \fIitemDesc\fR. For every column of the treectrl there may be specified one \fIlist\fR, @@ -1234,6 +1283,12 @@ given value(s); in this case the command returns an empty string. The options and values are the same as those permissible in the \fBitem create\fR command when the item was created. .TP +\fIpathName\fR \fBitem count\fR\fR +Returns a decimal string giving the number of +items created by the \fBitem create\fR widget command which haven't been +deleted by the \fBitem delete\fR widget command, plus 1 for the ever-present +root item. +.TP \fIpathName\fR \fBitem create\fR ?\fIoption value ...\fR?\fR Creates a new item and returns its unique identifier. The new item has the states \fBopen\fR and \fBenabled\fR set by default. @@ -1349,13 +1404,10 @@ If \fIchild\fR is specified, it must described an item that is not an ancestor of \fIparent\fR. Then it will become the new first child of \fIparent\fR. .TP -\fIpathName\fR \fBitem index\fR \fIitemDesc\fR\fR -Returns a list of two integers, which corresponds to the row -of the item described by \fIitemDesc\fR, -if all items above are counted and if only the displayed items are counted. -This command should not be confused with the \fBindex\fR widget command, -which return the invariable item id. -The index here is basically the row of the item. +\fIpathName\fR \fBitem id\fR \fIitemDesc\fR\fR +This command resolves the item description \fIitemDesc\fR into a unique item +identifier (see \fBITEM DESCRIPTION\fR below). If the item described by +\fIitemDesc\fR doesn't exist, this command returns an empty string. .TP \fIpathName\fR \fBitem isancestor\fR \fIitemDesc\fR \fIdescendant\fR\fR Returns 1 if the item described by \fIitemDesc\fR is a direct or indirect @@ -1382,6 +1434,15 @@ Then it will become the new next sibling of \fIsibling\fR. \fIpathName\fR \fBitem numchildren\fR \fIitemDesc\fR\fR Returns the number of children of the item described by \fIitemDesc\fR. .TP +\fIpathName\fR \fBitem order\fR \fIitemDesc\fR ?\fI-visible\fR?\fR +This command returns the position of the item \fIitemDesc\fR 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 +\fI-visible\fR 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. +.TP \fIpathName\fR \fBitem parent\fR \fIitemDesc\fR\fR Returns the numerical index of the parent of the item described by \fIitemDesc\fR. @@ -1411,7 +1472,7 @@ which should be children of the item described by \fIitemDesc\fR; the order between these two limiting items doesn't matter. .sp The sort column can be specified by means of the \fB-column\fR 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 \fItext\fR of the element specified by the \fB-element\fR option, which must be a text element defined in the style of the sorting column, @@ -1783,18 +1844,10 @@ Use \fBnotify uninstall\fR with a \fIpattern\fR of <\fIeventName\fR> instead. .RE .TP \fIpathName\fR \fBnumcolumns\fR\fR -Returns a decimal string giving the number of -columns created by the \fBcolumn create\fR widget command which haven't been -deleted by the \fBcolumn delete\fR widget command. The \fBtail\fR column -is not counted. +Deprecated. Use the \fBcolumn count\fR command instead. .TP \fIpathName\fR \fBnumitems\fR\fR -Returns a decimal string giving the number of -items created by the \fBitem create\fR widget command which haven't been -deleted by the \fBitem delete\fR 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 \fBitem count\fR command instead. .TP \fIpathName\fR \fBorphans\fR\fR Returns a list containing the numerical ids of all items @@ -2125,11 +2178,8 @@ A treectrl widget is capable of displaying multiple columns next to each other. An item can be considered as a row, which reaches over all columns. .PP -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 \fIN\fR, where \fIN\fR -is one less than the result of the \fBnumcolumns\fR widget command. -A column may also be named by the value of its \fB-tag\fR configuration -option. +Columns in a treectrl may be specified in a number of ways. +See \fBCOLUMN DESCRIPTION\fR below. .PP There is always one special column, the \fBtail\fR column, which fills all space to the right of the last ordinary column. @@ -2151,11 +2201,11 @@ to the right of the column title. .TP \fB\fB-arrowbitmap\fR\fR \fIbitmap\fR Specifies as a per-state option the bitmap to use to draw the arrow if -this columns -arrow option is not \fBnone\fR. +this column's -arrow option is not \fBnone\fR. .TP \fB\fB-arrowimage\fR\fR \fIimage\fR Specifies as a per-state option the image to use to draw the arrow if -this columns -arrow option is not \fBnone\fR. If an image is specified for +this column's -arrow option is not \fBnone\fR. If an image is specified for a certain state, it overrides the -arrowbitmap option. .TP \fB\fB-arrowside\fR\fR \fIside\fR @@ -2310,6 +2360,52 @@ a) the tree \fB-orientation\fR option is \fBvertical\fR; b) only a single tree column is visible; c) the single visible tree column \fB-width\fR option is zero; d) and the tree \fB-wrap\fR option results in wrapping. +.SH "COLUMN DESCRIPTION" +Many of the commands and options for a treectrl take as an argument a +description of which column to operate on. +See the \fBEXAMPLES\fR section for examples. +The initial part of a column description must begin with one of the following terms: +.TP +\fIid\fR +Specifies the unique column identifier, where \fIid\fR should be +the return value of a prior call of the \fBcolumn create\fR widget command. +.TP +\fItag\fR +Specifies the value of a column's -tag option. +.TP +\fBall\fR +Indicates every column, including the tail column. Not all commands accept this. +.TP +\fBfirst\fR ?\fBvisible\fR? +Indicates the leftmost column of the treectrl. +If \fBvisible\fR is specified, the leftmost column whose -visible option +is true is used. +.TP +\fBlast\fR ?\fBvisible\fR? +Indicates the rightmost column of the treectrl (but not the tail column). +If \fBvisible\fR is specified, the rightmost column whose -visible option +is true is used. +.TP +\fBorder\fR \fIn\fR ?\fBvisible\fR? +Indicates the \fIn\fRth column in the list of columns as returned by the +\fBcolumn order\fR command. +.TP +\fBtail\fR +Indicates the ever-present tail column of the treectrl. +.PP +The initial part of the column description (matching any of the values above) +may be followed by one or more \fImodifier\fRs. +A modifier changes the column used relative to +the description up to this point. +It may be specified in any of the following forms: +.TP +\fBnext\fR ?\fBvisible\fR? +Use the column to the right, or the column to the right whose -visible option +is true. +.TP +\fBprev\fR ?\fBvisible\fR? +Use the column to the left, or the column to the left whose -visible option +is true. .SH "STATES" A state consists basically of just a string: its \fIstateName\fR. For every item a set of these states is managed, @@ -2379,7 +2475,7 @@ However, to use a different font when the item is selected you could write: .nf $T element configure MyTextElement -font {{Courier 10} selected {Times 12 bold} {}} .fi -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 \fIstateList\fR is an empty list, the preceding \fIvalue\fR 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 @@ -2585,15 +2681,15 @@ the \fBelement create\fR or \fBelement configure\fR commands, only by the \fBitem element configure\fR command; i.e., the element must be associated with a particular item. .SH "ITEM DESCRIPTION" -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 \fIitemDesc\fRs 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 \fBEXAMPLES\fR section for examples. +The initial part of an item description must begin with one of the following terms: .TP -\fInumber\fR -Specifies the item numerically, where \fInumber\fR should be +\fIid\fR +Specifies the unique item identifier, where \fIid\fR should be the return value of a prior call of the \fBitem create\fR widget command, -or \fB0\fR to specify the root item. +or \fB0\fR to specify the ever-present root item. .TP \fBactive\fR Indicates the item that is currently active, i.e. normally @@ -2627,8 +2723,9 @@ You can memorize \fBrnc\fR as abbreviation of "row 'n' column". \fBroot\fR Indicates the root item of the treectrl. .PP -The \fIitemDesc\fR may be followed by one or more \fImodifier\fRs. -A modifier changes the item described by the \fIitemDesc\fR relative to +The initial part of the column description (matching any of the values above) +may be followed by one or more \fImodifier\fRs. +A modifier changes the item used relative to the description up to this point. It may be specified in any of the following forms: .TP @@ -2879,6 +2976,32 @@ the Return key toggles the active item. The mousewheel scrolls the view of the widget four lines up or down depending on the direction, the wheel was turned. The active cursor or the selection is not affected. +.SH "EXAMPLES" +Get the unique identifier for the leftmost visible column: +.nf +set id [$T column index "first visible"] +.fi +Delete the leftmost column: +.nf +$T column delete "order 0" +.fi +Take the visible column that is to the left of the last column, and move that +column in front of the tail column: +.nf +$T column move "last prev visible" tail +.fi +Get the unique identifier for the first visible item: +.nf +set id [$T item index "first visible"] +.fi +Delete the parent of the item that is under the point x,y: +.nf +$T item delete "nearest $x $y parent" +.fi +Add the 10th child of the second child of the root item to the selection: +.nf +$T selection add "root firstchild nextsibling child 10" +.fi .SH "SEE ALSO" bind(n), bitmap(n), image(n), listbox(n), options(n) .SH "KEYWORDS" |