diff options
| author | treectrl <treectrl> | 2006-11-19 00:56:19 (GMT) |
|---|---|---|
| committer | treectrl <treectrl> | 2006-11-19 00:56:19 (GMT) |
| commit | cf436c12cdc13de9e5e3bbe5b8d546e3a14169e5 (patch) | |
| tree | 687f3a8dc86c19a843f2fa2669f2ec3c3e76c608 /doc | |
| parent | 281acf61bfbd3da428e8583dcf43897925d6295e (diff) | |
| download | tktreectrl-cf436c12cdc13de9e5e3bbe5b8d546e3a14169e5.zip tktreectrl-cf436c12cdc13de9e5e3bbe5b8d546e3a14169e5.tar.gz tktreectrl-cf436c12cdc13de9e5e3bbe5b8d546e3a14169e5.tar.bz2 | |
Added 2 optional arguments to [selection get] to perform lindex- and lrange-like operations on the sorted list of selected items.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/What's New in TkTreeCtrl.html | 8863 | ||||
| -rw-r--r-- | doc/treectrl.html | 23 | ||||
| -rw-r--r-- | doc/treectrl.man | 19 | ||||
| -rw-r--r-- | doc/treectrl.n | 23 |
4 files changed, 107 insertions, 8821 deletions
diff --git a/doc/What's New in TkTreeCtrl.html b/doc/What's New in TkTreeCtrl.html index 4fc90c5..df316b7 100644 --- a/doc/What's New in TkTreeCtrl.html +++ b/doc/What's New in TkTreeCtrl.html @@ -1,2192 +1,440 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
-<!-- $Id: What's\040New\040in\040TkTreeCtrl.html,v 1.19 2006/11/18 04:40:10 treectrl Exp $ -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+<!-- $Id: What's\040New\040in\040TkTreeCtrl.html,v 1.20 2006/11/19 00:56:19 treectrl Exp $ -->
<meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
+ <title>What's New in TkTreeCtrl</title>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- <title>What's New in TkTreeCtrl</title>
<meta content="Tim Baker" name="author">
+
</head>
<body>
-
-
-
-
-
-
-
-
-
-
<h1>What's New in TkTreeCtrl 2.2</h1>
-
-
-
-
-
-
-
-
-
-
<h2>TreeCtrl Configuration Options</h2>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
<tbody>
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Deprecated</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-defaultstyle</td>
-
-
-
-
-
-
-
-
-
-
<td>The -itemstyle option of a column.</td>
-
-
-
</tr>
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>TreeCtrl Command</h2>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
<tbody>
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>contentbox</td>
-
-
-
-
-
-
-
-
-
-
<td>The return value is an empty string if the
content area is totally obscurred by column headers, borders, and/or
locked columns. Typically this will only happen if the window is too
small.</td>
-
-
</tr>
+ <tr>
+ <td>selection get</td>
-
-
-
- </tbody>
-</table>
-
-
-
-<h2>Column Configuration Options</h2>
-
-
-
-
-
+ <td>Accepts 2 optional arguments to allow in-place <span style="font-weight: bold;">lindex</span> and <span style="font-weight: bold;">lrange</span> queries of
+the selection. For example:<br>
+ <pre>.t selection get 0 ; # the first selected item<br>.t selection get end ; # the last selected item<br>.t selection get 1 end-1 ; # every selected item except the first and last</pre>
+ </td>
+ </tr>
+ </tbody>
+</table>
+<h2>Column Configuration Options</h2>
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Renamed<br>
-
-
-
-
-
-
-
-
-
-
</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">New
name</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-tag</td>
-
-
-
-
-
-
-
-
-
-
<td>-tags</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">Comment</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-lock</td>
-
-
-
-
-
-
-
-
-
-
<td>This option allows columns to stick to the left or
right edge
of the window. Locked columns can scroll vertically but not
horizontally. Valid values for this option are <span style="font-weight: bold;">none</span> (the default), <span style="font-weight: bold;">left</span> or <span style="font-weight: bold;">right</span>.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
<td>-itemstyle</td>
-
-
-
<td>Specifies the name of a style to set in this column for
newly-created items. This option replaces the treectrl option
-defaultstyle.</td>
-
-
-
</tr>
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-uniform</td>
-
-
-
-
-
-
-
-
-
-
<td colspan="1" rowspan="2">These two options
operate the same as the grid geometry manager options of the same name.
For example:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre style="margin-left: 40px;">.t column configure 0 -uniform a<br>.t column configure 1 -uniform a</pre>
+will give columns 0 and 1 the same requested width, whichever is the
+larger of the two columns. And:<br>
-
-
-
-
-
-
-
-
-
-will give columns 0 and 1 the same requested width, whichever is the larger of the two columns. And:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre style="margin-left: 40px;">.t column configure 0 -uniform a -weight 2<br>.t column configure 1 -uniform a</pre>
+will give column 0 twice the maximum of the requested widths of columns
+0 and 1. And:<br>
-
-
-
-
-
-
-
-
-will give column 0 twice the maximum of the requested widths of columns 0 and 1. And:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre style="margin-left: 40px;">.t column configure 0 -expand yes -weight 2<br>.t column configure 1 -expand yes</pre>
-
-
-
-
-
-
-
-
will give column 0 twice the extra space as column 1.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-weight</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Column Command</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
+
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
+
</tr>
+
<tr>
+
<td>column count</td>
- <td>Takes an optional column-description argument; the result is
+
+ <td>Takes an optional column-description argument; the
+result is
the number of columns that match the column description. For example:<br>
-
<pre>.t column count visible</pre>
will return the number of columns whose -visible option is true, and:<br>
-
<pre>.t column count {tag a^b}</pre>
-will return the number of columns with either tag "a" or "b", but not both.</td>
- </tr>
- <tr>
-
-
-
-
-
-
-
-
+will return the number of columns with either tag "a" or "b", but not
+both.</td>
+ </tr>
+ <tr>
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">Comment</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column tag add</td>
-
-
-
-
-
-
-
-
-
-
<td colspan="1" rowspan="4">Columns can have
a list of tag names. Previously only a single tag was allowed. The <span style="font-weight: bold;">tail</span> column no
longer has the word "tail" as a tag, but it is still referred to by the
word "tail" in column descriptions. </td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column tag expr</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column tag names</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column tag remove</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Item Configuration Options</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">Comment</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-tags</td>
-
-
-
-
-
-
-
-
-
-
- <td>
-
-
-
-
-
-Tags are textual labels applied to items to group them. Tags
+ <td>Tags are textual labels applied to items to group them.
+Tags
do not affect the appearance or behaviour of items. Tags can be used in
item descriptions to operate on multiple items. More information can be
found in the <a href="treectrl.html#item_tags">man page</a>.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Item Command</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item count</td>
+ <td>Takes an optional item-description argument; the result
+is the number of items that match the item description. For example:<br>
-
-
-
-
-
-
-
-
-
- <td>Takes an optional item-description argument; the result is the number of items that match the item description. For example:<br>
-
-
<pre>.t item count visible</pre>
will return the number of items that are displayed (i.e., those
whose ancestors are all expanded, -visible options are true, etc), and:<br>
-
<pre>.t item count {tag a^b}</pre>
-will return the number of items with either tag "a" or "b", but not both.</td>
-
-
-
-
-
-
-
-
-
-
+will return the number of items with either tag "a" or "b", but not
+both.</td>
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item create</td>
-
-
-
-
-
-
-
-
-
-
<td>New option <span style="font-weight: bold;">-tags</span>
specifies an initial list of tags for created items.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item id</td>
-
-
-
-
-
-
-
-
-
-
<td>Returns a list of item ids if the item description
matches multiple items. For example:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre>.t item id all</pre>
-
-
-
-
-
-
-
-
-
-
will return a list of ids for all items, and:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre>.t item id "$item children"</pre>
-
-
-
-
-
-
-
-
-
-
will return the ids of every child of an item.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">Comment</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item descendants</td>
-
-
-
-
-
-
-
-
-
-
<td>Returns the ids of the children, grandchildren, etc of
an item.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item enabled</td>
-
-
-
-
-
-
-
-
-
-
<td>Gets and sets the <span style="font-weight: bold;">enabled</span>
state for items. All items are enabled when first created. Disabled
items cannot be selected, and are ignored by the default key-navigation
and mouse bindings.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item tag add</td>
-
-
-
-
-
-
-
-
-
-
<td>Add tags to items. For example:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre>.t item tag add all {a b c}</pre>
-
-
-
-
-
-
-
-
-
-
will add tags "a", "b" and "c" to every item.<br>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item tag expr</td>
-
-
-
-
-
-
-
-
-
-
<td>Evaluate a tag expression against items. For example:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre>.t item tag expr $item a</pre>
-
-
-
-
-
-
-
-
-
-
returns 1 if an item has tag "a". Also:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre>.t item tag expr $item a||b</pre>
-
-
-
-
-
-
-
-
-
-
returns 1 if an item has tag "a" or "b".</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item tag names</td>
-
-
-
-
-
-
-
-
-
-
<td>Return a list of tag names assigned to items. For
example:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre>.t item tag names $item</pre>
-
-
-
-
-
-
-
-
-
-
returns the tag list for an item, and:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre>.t item tag names all</pre>
-
-
-
-
-
-
-
-
-
-
returns every tag assigned to any item.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item tag remove</td>
-
-
-
-
-
-
-
-
-
-
<td>Remove tags from items. For example:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre>.t item tag remove all {b c}</pre>
-
-
-
-
-
-
-
-
-
-
will remove tags "b" and "c" from any items that have them.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
<h2>Text Element</h2>
-
-
-
-The new option <span style="font-weight: bold;">-underline</span> draws an underline under a single character of the displayed text.<br>
-
-
-
-
-
-
-
-
-
-
+The new option <span style="font-weight: bold;">-underline</span>
+draws an underline under a single character of the displayed text.<br>
<h2>Window Element</h2>
-
-
-
-
-
-
-
-
-
-
Window elements can now be properly clipped so they don't draw over the
column header, borders, or outside the bounds of the item
columns they occupy. This is accomplished by making the window you want
@@ -2194,52 +442,12 @@ to display a child of a borderless frame widget, and setting the new <span style window element to TRUE. So if your program displays a canvas widget in
a window element, you would change this code:<br>
-
-
-
-
-
-
-
-
-
-
<pre style="margin-left: 40px;">set canvas [canvas .t.canvas ...]<br>.t item element configure $item $column myElement -window $canvas</pre>
-
-
-
-
-
-
-
-
-
-
to this:<br>
-
-
-
-
-
-
-
-
-
-
<pre style="margin-left: 40px;">set frame [frame .t.clip -borderwidth 0]<br>set canvas [canvas $frame.canvas ...]<br>.t item element configure $item $column myElement -window $frame -clip yes</pre>
-
-
-
-
-
-
-
-
-
-
The <span style="font-weight: bold;">-clip</span>
option tells the window element to manage the geometry of both the <span style="font-weight: bold;">-window</span>
widget (i.e,
@@ -2249,1103 +457,268 @@ out-of-bounds. You can see this in the "Big List" and "Firefox Privacy" demos.
<h2>Item Descriptions</h2>
-
-
-
-
-
-
-
-
-
-
New keywords were added to allow multiple items to be specified by an <a href="treectrl.html#item_description">item description</a>:<br>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>The keyword <span style="font-weight: bold;">list</span>
specifies a list of other item descriptions:
-
-
-
-
-
-
-
-
-
-
<pre>.t item id "list [list $a $b $c]"</pre>
-
-
-
-
-
-
-
-
-
-
</li>
-
-
-
-
-
-
-
-
-
-
<li>The keyword <span style="font-weight: bold;">range</span>
operates like the <span style="font-weight: bold;">item
range</span> command:
-
-
-
-
-
-
-
-
-
-
<pre>.t item id "range $first $last"</pre>
-
-
-
-
-
-
-
-
-
-
</li>
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
New modifiers were added to match multiple items:
<ul>
-
-
-
-
-
-
-
-
-
-
<li>The modifier <span style="font-weight: bold;">ancestors</span>
operates like the <span style="font-weight: bold;">item
ancestors</span> command:
-
-
-
-
-
-
-
-
-
-
<pre>.t item id "$item ancestors"</pre>
-
-
-
-
-
-
-
-
-
-
</li>
-
-
-
-
-
-
-
-
-
-
<li>The modifier <span style="font-weight: bold;">children</span>
operates like the <span style="font-weight: bold;">item
children</span> command:
-
-
-
-
-
-
-
-
-
-
<pre>.t item id "$item children"</pre>
-
-
-
-
-
-
-
-
-
-
</li>
-
-
-
-
-
-
-
-
-
-
<li>The modifier <span style="font-weight: bold;">descendants</span>
operates like the <span style="font-weight: bold;">item
descendants</span> command:
-
-
-
-
-
-
-
-
-
-
<pre>.t item id "$item descendants"</pre>
-
-
-
-
-
-
-
-
-
-
</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
New qualifiers were added to refine which items are matched:<br>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
- <li>The qualifier <span style="font-weight: bold;">depth</span> matches items at a given depth in the heirarchy:</li>
-
-
-
-
-
-
-
+ <li>The qualifier <span style="font-weight: bold;">depth</span>
+matches items at a given depth in the heirarchy:</li>
</ul>
-
-
-
-
-
-
-
<div style="margin-left: 40px;">
<pre>.t item id "all depth 2" ; # find all items that are children of the root's children<br>.t item id "depth 2" ; # ditto</pre>
-
-
-
-
-
-
-
</div>
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
<li>The qualifier <span style="font-weight: bold;">!visible</span>
matches items that are not displayed:
-
-
-
-
-
-
-
-
-
-
<pre>.t item id "first !visible" ; # find the first item that is not displayed</pre>
-
-
-
-
-
-
-
-
-
-
</li>
-
-
-
-
-
-
-
-
-
-
<li>The qualifier <span style="font-weight: bold;">state</span>
matches items that have certain states set (or not set if '!' is used):
-
-
-
-
-
-
-
-
-
-
<pre>.t item id "first state {selected !open}" ; # find the first item that is selected and collapsed</pre>
-
-
-
-
-
-
-
-
-
-
</li>
-
-
-
-
-
-
-
-
-
-
<li>The qualifier <span style="font-weight: bold;">tag</span>
matches items that meet a tag expression:
-
-
-
-
-
-
-
-
-
-
<pre>.t item id "$item children tag {a && !b}" ; # find children of $item that have tag "a" but not tag "b"</pre>
-
-
-
-
-
-
-
-
-
-
</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
<br>
-
-
-
-
-
-
The keyword <span style="font-weight: bold;">all</span>
may now be followed by a list of qualifiers. For example:<br>
-
-
-
-
-
-
-
-
-
-
<pre style="margin-left: 40px;">.t item id "all !visible state myState" ; # find every item that is not displayed with user-defined state "myState"</pre>
-
-
-
-
-
-
A list of qualifiers may be used as the first part of an item
-description. This gives the same result as "all" followed by the
+description. This gives the same result as "all" followed by
+the
qualifiers. For example:<br>
-
-
-
-
-
-
<div style="margin-left: 40px;">
<pre>.t item id "!visible state myState" ; # same as the previous example</pre>
-
-
-
-
-
-
</div>
-
-
-
-
-
-
<h2>Column Descriptions</h2>
-
-
-
-
-
-
-
-
-
-
-New keywords <span style="font-weight: bold;">list</span> and
+New keywords <span style="font-weight: bold;">list</span>
+and
<span style="font-weight: bold;">range</span><span style="font-weight: bold;"></span> can be used to
match multiple columns.<br>
-
-
-
-
-
-
New qualifiers <span style="font-weight: bold;">state</span>,
<span style="font-weight: bold;">tag</span>, <span style="font-weight: bold;">!tail</span> and <span style="font-weight: bold;">!visible</span> can be used
to restrict which columns are specified.<br>
-
-
-
-
-
-
-The keyword <span style="font-weight: bold;">all</span> may be followed by a list of qualifiers.<br>
-
-
-
-
-
-
+The keyword <span style="font-weight: bold;">all</span>
+may be followed by a list of qualifiers.<br>
A list of qualifiers may used as the first part of a column
-description. This gives the same result as "all" followed by the
+description. This gives the same result as "all" followed by
+the
qualifiers.
<h2>Multi-item and multi-column commands</h2>
-
-
-
-
-
-
Many commands can now operate on multiple items and/or columns by using
the improved item descriptions and column descriptions mentioned above.
For example:
<div style="margin-left: 40px;">
<pre>.t column configure "range 1 10" -tags {a b c}<br>.t column delete "tag a"<br>.t column id "tag {a || b}"<br>.t item configure "depth 1" -button yes<br>.t item count visible<br>.t item element configure "root children" all elem1 -text "Hello"<br>.t item id "visible"<br>.t item image all all image1<br>.t item style map "tag {a && !b}" "tag c" style2 {style1.elem1 style2.elem2}<br>.t item style set all all style1<br>.t item state forcolumn all all state1<br>.t item state set "tag current" ~mouseover<br>.t item remove "state selected"<br>.t item span "range 1 10" "range 10 last" 2<br>.t item text "root children" all "Hello"</pre>
-
-
-
-
-
-
</div>
-
-
-
-
-
-
<h2>Demo Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>New demo "My Computer". Demonstrates disabled items used as
headers.</li>
-
-
-
-
-
-
-
-
-
-
<li>New demo "Column Locking". Demonstrates columns that do not
scroll horizontally.</li>
-
-
-
-
-
-
-
-
-
-
<li>The "Big List" and "Firefox Privacy" demos were changed to
use the new <span style="font-weight: bold;">-clip</span>
option of window elements.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
<h2>Misc Changes</h2>
-
<ul>
+ <li>The tail column header will not be drawn if the tail
+column's <span style="font-weight: bold;">-visible</span>
+option is false. This can look nicer with some themes.</li>
- <li>The tail column header will not be drawn if the tail column's <span style="font-weight: bold;">-visible</span> option is false. This can look nicer with some themes.</li>
-
-
- <li>The <span style="font-weight: bold;">-itembackground</span> colors for a column are now extended below any items in the simplest (and most typical) case where the treectrl's <span style="font-weight: bold;">-orient</span> option is vertical and <span style="font-weight: bold;">-wrap</span> option is unspecified. The height of the rows is determined by the <span style="font-weight: bold;">-itemheight</span> or <span style="font-weight: bold;">-minitemheight</span> options; if neither of those options is specified, then <span style="font-weight: bold;">-itembackground</span> colors are not drawn below the items.</li>
+ <li>The <span style="font-weight: bold;">-itembackground</span>
+colors for a column are now extended below any items in the simplest
+(and most typical) case where the treectrl's <span style="font-weight: bold;">-orient</span> option is
+vertical and <span style="font-weight: bold;">-wrap</span>
+option is unspecified. The height of the rows is determined by the <span style="font-weight: bold;">-itemheight</span> or <span style="font-weight: bold;">-minitemheight</span>
+options; if neither of those options is specified, then <span style="font-weight: bold;">-itembackground</span>
+colors are not drawn below the items.</li>
-
- <li>If <span style="font-weight: bold;">-itembackground</span> colors are specified for the tail column, then they are drawn.</li>
+ <li>If <span style="font-weight: bold;">-itembackground</span>
+colors are specified for the tail column, then they are drawn.</li>
<li>Memory usage is improved, especially for text elements.</li>
-
</ul>
-
-
-
-
-
-
-
-
-
-
<h2>Bug Fixes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li><span style="font-weight: bold;">item create</span>:
Fixed bug where <span style="font-weight: bold;">-nextsibling</span>
and <span style="font-weight: bold;">-prevsibling</span>
options could specify an orphan item.</li>
-
-
-
-
-
-
-
-
-
-
<li><span style="font-weight: bold;">item delete</span>:
Stopped items possibly being double-deleted by nested calls through <span style="font-weight: bold;"><Selection></span>
and <span style="font-weight: bold;"><ItemDelete></span>
binding scripts.</li>
-
-
-
-
-
-
-
-
-
-
<li><span style="font-weight: bold;">item expand</span>, <span style="font-weight: bold;">item collapse</span>, <span style="font-weight: bold;">item toggle</span>: Only
operate on items which exist when the command is called, not any that
might get created by <span style="font-weight: bold;"><Expand></span>
or <span style="font-weight: bold;"><Collapse></span>
binding scripts.</li>
-
-
-
-
-
- <li>Fixed a crash and a redisplay problem when a master element was
+ <li>Fixed a crash and a redisplay problem when a master element
+was
configured with a -textvariable and the associated variable changed.</li>
-
-
-
-
-
-
-
-
-
-
<li>When a style with window elements spanned more than one
column, the window might be improperly sized during display updates.</li>
-
-
-
-
-
-
-
-
-
-
<li>Windows in window elements would not always be unmapped if
columns or items were hidden, or if the span of an item-column changed.</li>
-
- <li>The disclosure triangles (i.e., the item buttons) are drawn without a white background under OSX.</li>
-
-
-
-
-
-
-
-
-
-
+ <li>The disclosure triangles (i.e., the item buttons) are drawn
+without a white background under OSX.</li>
</ul>
-
-
-
-
-
-
-
-
-
-
<hr style="width: 100%; height: 2px;">
<h1>What's New in TkTreeCtrl 2.1.1</h1>
-
-
-
-
-
-
-
-
-
-
<h2>Column Command</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column delete<br>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
<td>Added an optional second argument allowing a range of
columns to be deleted.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Bug Fixes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>The <span style="font-weight: bold;">item sort</span>
command
will be much faster in many cases. There was a silly error in the
pivot-finding code of quicksort which resulted in the slow-down.</li>
-
-
-
-
-
-
-
-
-
-
<li>A column header will be redisplayed if an image in
the header is altered.</li>
-
-
-
-
-
-
-
-
-
-
<li>Fixed bus errors on some Unix systems due to alignment
problems.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<h2>Other Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>The Tk caret is now positioned over the active item when it
changes. The Tk caret is used for the Magnifier accessibility
application and IME on Windows, as well as XIM under Unix.</li>
-
-
-
-
-
-
-
-
-
-
<li>Improved the appearance of the column headers under OSX.</li>
-
-
-
-
-
-
-
-
-
-
<li>Added <MouseWheel> support to OSX.</li>
-
-
-
-
-
-
-
-
-
-
<li>Changing the -visible option of an item could be slow if
any
items were selected. That is because non-visible items may not be part
@@ -3353,2286 +726,416 @@ of the selection. A change was made so that changes to the selection caused by modifying the -visible option of an item do not occur until
the next display update.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<h2>Demo Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>New demo "Column Spanning". Demonstrates a 100-column list
where styles span from 1 to 20 columns each.</li>
-
-
-
-
-
-
-
-
-
-
<li>The <span style="font-weight: bold;">loupe</span>
command (which performs screen capture to an image) is now implemented
on Windows and OSX thanks to Jeff Hobbs.</li>
-
-
-
-
-
-
-
-
-
-
<li>The screen-magnifier image now resizes with the "loupe"
window.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<hr style="width: 100%; height: 2px;">
<h1>What's New in TkTreeCtrl 2.1</h1>
-
-
-
-
-
-
-
-
-
-
This version should be backwards compatible with 2.0, except for a few
obscure changes.<br>
-
-
-
-
-
-
-
-
-
-
<h2>TreeCtrl Configuration Options</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">Comment</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-itemwidth</td>
-
-
-
-
-
-
-
-
-
-
<td><br>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-itemwidthequal</td>
-
-
-
-
-
-
-
-
-
-
<td>Deprecates the column -widthhack option.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-itemwidthmultiple</td>
-
-
-
-
-
-
-
-
-
-
<td>Deprecates the column -stepwidth option.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Column Configuration Options</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Deprecated</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-stepwidth</td>
-
-
-
-
-
-
-
-
-
-
<td>treectrl's -itemwidthmultiple option</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-widthhack</td>
-
-
-
-
-
-
-
-
-
-
<td>treectrl's -itemwidthequal option</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Element Command</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">Comment</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>element perstate</td>
-
-
-
-
-
-
-
-
-
-
<td>Like [item element perstate].</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Item Configuration Options</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">Comment</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-height</td>
-
-
-
-
-
-
-
-
-
-
<td>Overrides the treectrl's -itemheight option</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Item Command</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204);">Deprecated</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item element actual</td>
-
-
-
-
-
-
-
-
-
-
<td>item element perstate</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item complex</td>
-
-
-
-
-
-
-
-
-
-
<td>item element configure</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204);">Behaviour
Changed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item bbox</td>
-
-
-
-
-
-
-
-
-
-
<td>No longer returns an error if no style had been
assigned to the column.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item state forcolumn</td>
-
-
-
-
-
-
-
-
-
-
<td>No longer returns an error if no style had been
assigned to the column.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item style set</td>
-
-
-
-
-
-
-
-
-
-
<td>Does nothing when replacing a style with the same
style.
Previously the old style was freed before assigning the new style,
losing the element config info if the old and new styles were the same.<br>
-
-
-
-
-
-
-
-
-
-
<span style="color: rgb(255, 0, 0);">Potential
incompatibility</span></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item create</td>
-
-
-
-
-
-
-
-
-
-
<td>Added options: -count -height, -nextsibling, -open,
-parent,
-prevsibling, and -returnid. Multiple items may be created with one
call using the -count option.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item element configure</td>
-
-
-
-
-
-
-
-
-
-
<td>Multiple elements in multiple columns may be configured
with
a single call. Use '+' to separate elements, and ',' to separate
columns. See the docs.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item style set</td>
-
-
-
-
-
-
-
-
-
-
<td>When no column is specified, returns a list of one
style name
per column. Previously, the list would have less values than the number
of columns if no styles had ever been assigned to the rightmost
column(s).<br>
-
-
-
-
-
-
-
-
-
-
<span style="color: rgb(255, 0, 0);">Potential
incompatibility</span></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item text</td>
-
-
-
-
-
-
-
-
-
-
<td>When no column is specified, returns a list of one
string per column.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">Comment</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item image</td>
-
-
-
-
-
-
-
-
-
-
<td>Partner to the [item text] command.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item element perstate</td>
-
-
-
-
-
-
-
-
-
-
<td>Not really new, just renamed from [item element actual]
to
better describe what it does. Accepts a new optional argument which
specifies the state to use when determining the value of the per-state
option.<br>
-
-
-
-
-
-
-
-
-
-
<br>
-
-
-
-
-
-
-
-
-
-
The following options no longer return a default value if the per-state
option itself does not have a value specified:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>bitmap -foreground, -background</li>
-
-
-
-
-
-
-
-
-
-
<li>border -relief</li>
-
-
-
-
-
-
-
-
-
-
<li>text -fill, -font</li>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<span style="color: rgb(255, 0, 0);">Potential
incompatibility</span></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item span</td>
-
-
-
-
-
-
-
-
-
-
<td>A style may now be displayed over multiple adjacent
columns.<br>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2><span style="font-weight: bold;"></span>Notify
Command</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">Comment</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>notify unbind<br>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
<td>Let's you unbind all scripts from an object with one
call.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Style Layout Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>Column justification will now affect the position of
elements in 2 situations which previously had no effect (<span style="color: rgb(255, 0, 0);">Potential incompatibility</span>):</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<ol style="margin-left: 40px;">
-
-
-
-
-
-
-
-
-
-
<li>If a -detach element had a fixed width larger than the
other elements.</li>
-
-
-
-
-
-
-
-
-
-
<li>If an element had -iexpand x specified as well as
-maxwidth, leaving some space available.</li>
-
-
-
-
-
-
-
-
-
-
</ol>
-
-
-
-
-
-
-
-
-
-
<h2>Element Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>Bitmap, image and text elements are drawn clipped if given
less space than they need.</li>
-
-
-
-
-
-
-
-
-
-
<li>Fixed line wrapping of text elements. It did not work for
single lines of text at all (<span style="color: rgb(255, 0, 0);">Potential
incompatibility</span>).</li>
-
-
-
-
-
-
-
-
-
-
<li>The text -wrap option can now be <span style="font-weight: bold;">none</span> to disable line
wrapping.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<h2>Event Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>The new static event <span style="font-weight: bold;"><ItemVisibility></span>
is generated when items become visible on screen and when items are no
longer visible on screen.
@@ -5641,523 +1144,103 @@ styles when items are about to be displayed. See the EVENTS AND SCRIPT SUBSTITUTIONS section in the help
file, and the new demo "Big List".</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<h2>Other Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>On WinXP, the column header sort arrow is drawn like
Explorer draws it if <span style="font-weight: bold;">-usetheme</span>
is true.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<h2>Demo Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>New demo "Big List". Demonstrates the new <span style="font-weight: bold;"><ItemVisibility></span>
event, using <Expand-before> to add items on demand, and
column spanning.</li>
-
-
-
-
-
-
-
-
-
-
<li>The context menu has a <span style="font-weight: bold;">Span</span>
submenu that lets you manipulate column spanning in items. See
the <span style="font-weight: bold;">item span</span>
command in the help file.</li>
-
-
-
-
-
-
-
-
-
-
<li>Under WinXP, the "Explorer" demos will use the new <span style="font-weight: bold;">shellicon</span>
extension if available. This extension allows a treectrl to display
file/folder icons using the Win32 Shell API. It may work on other
versions of Windows but it hasn't been tested.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<hr style="width: 100%; height: 2px;">
<h1>What's New in TkTreeCtrl 2.0</h1>
-
-
-
-
-
-
-
-
-
-
<h2>TreeCtrl Configuration Options</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Replaced</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-openbuttonimage</td>
-
-
-
-
-
-
-
-
-
-
<td>-buttonimage</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-closedbuttonimage</td>
-
-
-
-
-
-
-
-
-
-
<td>-buttonimage</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-openbuttonbitmap</td>
-
-
-
-
-
-
-
-
-
-
<td>-buttonbitmap</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-closedbuttonbitmap</td>
-
-
-
-
-
-
-
-
-
-
<td>-buttonbitmap</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Usage
Changed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">How
it changed</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-backgroundmode</td>
-
-
-
-
-
-
-
-
-
-
<td>The values "index" and "visindex" are deprecated. The
value
"order" should be used instead of "index", and
@@ -6165,4419 +1248,769 @@ value agreement with the new "item order" command which replaces the "item
index" command.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-treecolumn</td>
-
-
-
-
-
-
-
-
-
-
<td>This used to be any integer value which may or may not
have
corresponded to an actual column. Now the value must be a valid column
description, or an empty string to indicate no column should display
buttons/lines.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204);">New</th>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-backgroundimage</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-columnprefix</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-columnresizemode</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-itemprefix</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-minitemheight</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-usetheme</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>TreeCtrl Commands</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="width: 50%; background-color: rgb(255, 255, 204);">Deprecated</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>compare</td>
-
-
-
-
-
-
-
-
-
-
<td>item compare</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>index</td>
-
-
-
-
-
-
-
-
-
-
<td>item id</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>numcolumns</td>
-
-
-
-
-
-
-
-
-
-
<td>column count</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>numitems</td>
-
-
-
-
-
-
-
-
-
-
<td>item count</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>range</td>
-
-
-
-
-
-
-
-
-
-
<td>item range</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Column Configuration Options</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Removed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-relief<br>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
<td>-state</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-sunken</td>
-
-
-
-
-
-
-
-
-
-
<td>-state</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204);">Renamed<br>
-
-
-
-
-
-
-
-
-
-
</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">New
name</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-arrowpad</td>
-
-
-
-
-
-
-
-
-
-
<td>-arrowpadx</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204);">Usage
Changed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">How
it changed</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-background</td>
-
-
-
-
-
-
-
-
-
-
<td>This is now a per-state option. See COLUMNS in the help
file
for valid state names.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204);">New<br>
-
-
-
-
-
-
-
-
-
-
</th>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-arrowbitmap<br>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-arrowimage</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-arrowpady</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-maxwidth</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-resize</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-state</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-textlines</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Column Command</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204);">Deprecated</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column index</td>
-
-
-
-
-
-
-
-
-
-
<td>column id</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column configure<br>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
<td>A column description of "all" is allowed if at least
one
option-value pair is given.<br>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column create</td>
-
-
-
-
-
-
-
-
-
-
<td>The result is a unique identifier. Previously the
result was
an
index in the list of columns.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column delete</td>
-
-
-
-
-
-
-
-
-
-
<td>A column description of "all" is allowed.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204);">New</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">Comment</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column compare</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column count</td>
-
-
-
-
-
-
-
-
-
-
<td>replaces "numcolumns"</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column dragconfigure</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column dragcget</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column id</td>
-
-
-
-
-
-
-
-
-
-
<td>replaces "column index"</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column list</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>column order</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Item Command</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204);">Removed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item index</td>
-
-
-
-
-
-
-
-
-
-
<td>item order</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">Comment</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item compare</td>
-
-
-
-
-
-
-
-
-
-
<td>replaces "compare"</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item count</td>
-
-
-
-
-
-
-
-
-
-
<td>replaces "numitems"</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item id</td>
-
-
-
-
-
-
-
-
-
-
<td>replaces "index"</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item order</td>
-
-
-
-
-
-
-
-
-
-
<td>replaces "item index"</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>item range</td>
-
-
-
-
-
-
-
-
-
-
<td>replaces "range"</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Notify Command</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>notify generate<br>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
<td>Added optional <span style="font-style: italic;">percentsCommand</span>
argument</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>notify install</td>
-
-
-
-
-
-
-
-
-
-
<td>Old syntax (supported but deprecated):<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre style="margin-left: 40px;"><span style="font-weight: bold;">notify install event</span> <span style="font-style: italic;">eventName</span></pre>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre style="margin-left: 40px;"><span style="font-weight: bold;">notify install detail</span> <span style="font-style: italic;">eventName</span> <span style="font-style: italic;">detail</span></pre>
-
-
-
-
-
-
-
-
-
-
New syntax:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre style="margin-left: 40px;"><span style="font-weight: bold;">notify install</span> <<span style="font-style: italic;">eventName</span>></pre>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre style="margin-left: 40px;"><span style="font-weight: bold;">notify install</span> <<span style="font-style: italic;">eventName</span>-<span style="font-style: italic;">detail</span>></pre>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>notify linkage</td>
-
-
-
-
-
-
-
-
-
-
<td>Old syntax (supported but deprecated):<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<div style="margin-left: 40px;">
-
-
-
-
-
-
-
-
-
-
<pre><span style="font-weight: bold;">notify linkage</span> <span style="font-style: italic;">eventName</span></pre>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre><span style="font-weight: bold;">notify linkage</span> <span style="font-style: italic;">eventName</span> <span style="font-style: italic;">detail</span></pre>
-
-
-
-
-
-
-
-
-
-
</div>
-
-
-
-
-
-
-
-
-
-
New syntax:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<div style="margin-left: 40px;">
-
-
-
-
-
-
-
-
-
-
<pre><span style="font-weight: bold;">notify linkage</span> <<span style="font-style: italic;">eventName</span>></pre>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<pre><span style="font-weight: bold;">notify linkage</span> <<span style="font-style: italic;">eventName</span>-<span style="font-style: italic;">detail</span>></pre>
-
-
-
-
-
-
-
-
-
-
</div>
-
-
-
-
-
-
-
-
-
-
</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>notify uninstall</td>
-
-
-
-
-
-
-
-
-
-
<td>see <span style="font-weight: bold;">notify
install</span>
above</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Style Layout Options</h2>
-
-
-
-
-
-
-
-
-
-
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
-
-
-
-
-
-
-
-
-
-
<tbody>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(255, 255, 204);">Usage
Changed</th>
-
-
-
-
-
-
-
-
-
-
<th style="background-color: rgb(204, 255, 255);">How
it changed</th>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-iexpand</td>
-
-
-
-
-
-
-
-
-
-
<td>Two new flags "x' and "y" are allowed. Previously, only
the
-ipadx and -ipady padding could be expanded by this option. The new xy
flags expand the display area of the element, not the padding. To
update your code, you will probably want to change this:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<div style="margin-left: 40px;">
-
-
-
-
-
-
-
-
-
-
<pre>$T style layout $S $E -iexpand we</pre>
-
-
-
-
-
-
-
-
-
-
</div>
-
-
-
-
-
-
-
-
-
-
to this:<br>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
<div style="margin-left: 40px;">
-
-
-
-
-
-
-
-
-
-
<pre>$T style layout $S $E -iexpand x<br></pre>
-
-
-
-
-
-
-
-
-
-
</div>
-
-
-
-
-
-
-
-
-
-
Keep in mind that -union elements are not affected by -iexpand xy,
since the size of a -union element is determined by the elements it
surrounds.</td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<th style="width: 50%; background-color: rgb(255, 255, 204);">New<br>
-
-
-
-
-
-
-
-
-
-
</th>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-height</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-maxheight</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-maxwidth</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-minheight</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-minwidth</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-sticky</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
<tr>
-
-
-
-
-
-
-
-
-
-
<td>-width</td>
-
-
-
-
-
-
-
-
-
-
<td></td>
-
-
-
-
-
-
-
-
-
-
</tr>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
</tbody>
</table>
-
-
-
-
-
-
-
-
-
-
<h2>Element Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>A new element type <span style="font-weight: bold;">window</span>
was added.
See the new demo "Firefox Privacy" and the ELEMENTS section in the help
file.</li>
-
-
-
-
-
-
-
-
-
-
<li>All element types have a new
per-state boolean option called <span style="font-weight: bold;">-draw</span>.</li>
-
-
-
-
-
-
-
-
-
-
<li>The <span style="font-weight: bold;">text</span>
element type
has a new option called <span style="font-weight: bold;">-textvariable</span>.
See the new demo
"Textvariable" and the ELEMENTS section in the help file.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<h2>Event Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>2 new %-substitution characters <span style="font-weight: bold;">%P</span>
and <span style="font-weight: bold;">%?</span> are
allowed in binding
scripts. See the EVENTS AND SCRIPT SUBSTITUTIONS section in the help
file.</li>
-
-
-
-
-
-
-
-
-
-
<li>The new static event <span style="font-weight: bold;"><ItemDelete></span>
is generated when items are deleted. See the EVENTS AND SCRIPT
SUBSTITUTIONS section in the help file.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<h2>Library Script Changes</h2>
-
-
-
-
-
-
-
-
-
-
<h3 style="margin-left: 40px;">filelist-bindings.tcl:</h3>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>The Priv(edit) variable, which is used to specify which
text
elements may be edited, now has the same format as Priv(sensitive).
Previously only elements in the first column could be edited.</li>
-
-
-
-
-
-
-
-
-
-
<li>3 new commands in the TreeCtrl namespace should be used to
access
the Priv(dragimage), Priv(edit) and Priv(sensitive) variables. The
commands are SetDragImage, SetEditable and SetSensitive.</li>
-
-
-
-
-
-
-
-
-
-
<li>Two new dynamic events <span style="font-weight: bold;"><Edit-begin></span>
and <span style="font-weight: bold;"><Edit-end></span>
are
generated when editing a file name.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<h3 style="margin-left: 40px;">treectrl.tcl:</h3>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>On OSX/Aqua, the Command key is used to perform
discontinuous
selection. Previously the Control key was used but Command is specified
by Apple's user-interface guidelines.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<h2>Other Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>On WinXP, the column headers and open/close buttons are
drawn
using the system theme if <span style="font-weight: bold;">-usetheme</span>
is true. The sort arrow is drawn the old-fashioned way.</li>
-
-
-
-
-
-
-
-
-
-
<li>On OSX/Aqua, the column headers and open/close
buttons are
drawn
@@ -10587,96 +2020,26 @@ well. This will override the <span style="font-weight: bold;">-arrowside</span> and <span style="font-weight: bold;">-arrowgravity</span>
options.</li>
-
-
-
-
-
-
-
-
-
-
<li>Columns can be moved by drag-and-drop. See <span style="font-weight: bold;">column dragconfigure</span>
in the help
file.</li>
-
-
-
-
-
-
-
-
-
-
<li>Columns can be specified in new ways. See the COLUMN
DESCRIPTION
section in the help file.</li>
-
-
-
-
-
-
-
-
-
-
<li>Added new section DYNAMIC EVENTS to the help file.</li>
-
-
-
-
-
-
-
-
-
-
<li>Added new section PER-STATE OPTIONS to the help file.</li>
-
-
-
-
-
-
-
-
-
-
<li>The new style layout option <span style="font-weight: bold;">-indent</span>
allows elements to be displayed in the button/line area. See the <span style="font-weight: bold;">style layout</span> command
in the help
file and the new demo "Firefox Privacy".</li>
-
-
-
-
-
-
-
-
-
-
<li>The new item description <span style="font-weight: bold;">end</span>
is equivalent to <span style="font-weight: bold;">last</span>.</li>
-
-
-
-
-
-
-
-
-
-
<li><span style="color: rgb(255, 0, 0);">If you
have version 1.1
installed, replace the old pkgIndex.tcl file with the one from this
@@ -10685,133 +2048,33 @@ file will set the TREECTRL_LIBRARY variable which will override where the library
scripts are found.</span></span></li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
<h2>Demo Changes</h2>
-
-
-
-
-
-
-
-
-
-
<ul>
-
-
-
-
-
-
-
-
-
-
<li>New demo "Firefox Privacy". Demonstrates the new <span style="font-weight: bold;">window</span> element type
and <span style="font-weight: bold;">-indent</span>
style layout option.</li>
-
-
-
-
-
-
-
-
-
-
<li>New demo "Textvariable". Demonstrates the new <span style="font-weight: bold;">-textvariable</span> option
of the <span style="font-weight: bold;">text</span>
element.</li>
-
-
-
-
-
-
-
-
-
-
<li>Added a new Event Browser window to display events
generated by
the main treectrl widget.</li>
-
-
-
-
-
-
-
-
-
-
<li>The context menu can be popped up in all the demo lists. A
<Control-ButtonPress-1> binding for this was added under
OSX/Aqua.</li>
-
-
-
-
-
-
-
-
-
-
<li>In the "Explorer" demos, the file name is hidden while
editing
the file name.</li>
-
-
-
-
-
-
-
-
-
-
</ul>
-
-
-
-
-
-
-
-
-
-
</body>
</html>
diff --git a/doc/treectrl.html b/doc/treectrl.html index d7281e8..d578ee0 100644 --- a/doc/treectrl.html +++ b/doc/treectrl.html @@ -1,10 +1,10 @@ -<! -- Copyright (c) 2002-2003 Christian Krone. -- -- See the file "license.terms" for information on usage and redistribution -- of this file, and for a DISCLAIMER OF ALL WARRANTIES. -- -- $Id: treectrl.html,v 1.41 2006/11/18 04:40:10 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.42 2006/11/19 00:56: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.41 2006/11/18 04:40:10 treectrl Exp $ treectrl.n +<! -- CVS: $Id: treectrl.html,v 1.42 2006/11/19 00:56:19 treectrl Exp $ treectrl.n --> <body> @@ -193,7 +193,7 @@ package require <b>treectrl 2.2</b><br> <tr valign=top ><td ><a href="#146"><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="#147"><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="#148"><i class='arg'>pathName</i> <b class='cmd'>selection count</b></a></td></tr> -<tr valign=top ><td ><a href="#149"><i class='arg'>pathName</i> <b class='cmd'>selection get</b></a></td></tr> +<tr valign=top ><td ><a href="#149"><i class='arg'>pathName</i> <b class='cmd'>selection get</b> ?<i class='arg'>first</i>? ?<i class='arg'>last</i>?</a></td></tr> <tr valign=top ><td ><a href="#150"><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="#151"><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="#152"><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> @@ -2542,12 +2542,19 @@ Returns an integer indicating the number of items in the treectrl that are currently selected. <br><br> -<dt><a name="149"><i class='arg'>pathName</i> <b class='cmd'>selection get</b></a><dd> +<dt><a name="149"><i class='arg'>pathName</i> <b class='cmd'>selection get</b> ?<i class='arg'>first</i>? ?<i class='arg'>last</i>?</a><dd> -Returns a list containing the item ids of -all of the items in the treectrl that are currently selected. -If there are no items selected in the treectrl then an empty -string is returned. +When no additional arguments are given, the result is an unsorted list +containing the item ids of all of the items in the treectrl that are currently selected. +If there are no items selected in the treectrl, then an empty string is returned. +The optional arguments <i class='arg'>first</i> and <i class='arg'>last</i> are treated as indices into +the sorted list of selected items; these arguments allow in-place <b class='cmd'>lindex</b> +and <b class='cmd'>lrange</b> operations on the selection. +<p><table><tr><td bgcolor=black> </td><td><pre class='sample'> +.t selection get 0 ; # return the first selected item +.t selection get end ; # return the last selected item +.t selection get 1 end-1 ; # return every selected item except the first and last +</pre></td></tr></table></p> <br><br> <dt><a name="150"><i class='arg'>pathName</i> <b class='cmd'>selection includes</b> <i class='arg'>itemDesc</i></a><dd> diff --git a/doc/treectrl.man b/doc/treectrl.man index ad4329f..845d7c0 100644 --- a/doc/treectrl.man +++ b/doc/treectrl.man @@ -3,7 +3,7 @@ See the file "license.terms" for information on usage and redistribution of this file, and for a DISCLAIMER OF ALL WARRANTIES. - $Id: treectrl.man,v 1.42 2006/11/18 04:40:10 treectrl Exp $} + $Id: treectrl.man,v 1.43 2006/11/19 00:56:19 treectrl Exp $} ][manpage_begin treectrl n 2.2] [moddesc {Tk Commands}] [titledesc {Create and manipulate hierarchical multicolumn widgets}] @@ -1903,11 +1903,18 @@ selection. Returns an integer indicating the number of items in the treectrl that are currently selected. -[call [arg pathName] [cmd {selection get}]] -Returns a list containing the item ids of -all of the items in the treectrl that are currently selected. -If there are no items selected in the treectrl then an empty -string is returned. +[call [arg pathName] [cmd {selection get}] [opt [arg first]] [opt [arg last]]] +When no additional arguments are given, the result is an unsorted list +containing the item ids of all of the items in the treectrl that are currently selected. +If there are no items selected in the treectrl, then an empty string is returned. +The optional arguments [arg first] and [arg last] are treated as indices into +the sorted list of selected items; these arguments allow in-place [cmd lindex] +and [cmd lrange] operations on the selection. For example: +[example_begin] +.t selection get 0 ; # return the first selected item +.t selection get end ; # return the last selected item +.t selection get 1 end-1 ; # return every selected item except the first and last +[example_end] [call [arg pathName] [cmd {selection includes}] [arg itemDesc]] Returns 1 if the item described by [arg itemDesc] is currently diff --git a/doc/treectrl.n b/doc/treectrl.n index da1e794..9b5768a 100644 --- a/doc/treectrl.n +++ b/doc/treectrl.n @@ -6,7 +6,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" $Id: treectrl.n,v 1.58 2006/11/18 04:40:10 treectrl Exp $ +'\" $Id: treectrl.n,v 1.59 2006/11/19 00:56:19 treectrl Exp $ .so man.macros .TH "treectrl" n 2.2 treectrl "Tk Commands" .BS @@ -311,7 +311,7 @@ package require \fBtreectrl 2.2\fR .sp \fIpathName\fR \fBselection count\fR .sp -\fIpathName\fR \fBselection get\fR +\fIpathName\fR \fBselection get\fR ?\fIfirst\fR? ?\fIlast\fR? .sp \fIpathName\fR \fBselection includes\fR \fIitemDesc\fR .sp @@ -2456,11 +2456,20 @@ selection. Returns an integer indicating the number of items in the treectrl that are currently selected. .TP -\fIpathName\fR \fBselection get\fR -Returns a list containing the item ids of -all of the items in the treectrl that are currently selected. -If there are no items selected in the treectrl then an empty -string is returned. +\fIpathName\fR \fBselection get\fR ?\fIfirst\fR? ?\fIlast\fR? +When no additional arguments are given, the result is an unsorted list +containing the item ids of all of the items in the treectrl that are currently selected. +If there are no items selected in the treectrl, then an empty string is returned. +The optional arguments \fIfirst\fR and \fIlast\fR are treated as indices into +the sorted list of selected items; these arguments allow in-place \fBlindex\fR +and \fBlrange\fR operations on the selection. +.nf + +.t selection get 0 ; # return the first selected item +.t selection get end ; # return the last selected item +.t selection get 1 end-1 ; # return every selected item except the first and last + +.fi .TP \fIpathName\fR \fBselection includes\fR \fIitemDesc\fR Returns 1 if the item described by \fIitemDesc\fR is currently |