diff options
| author | treectrl <treectrl> | 2006-11-18 04:40:10 (GMT) |
|---|---|---|
| committer | treectrl <treectrl> | 2006-11-18 04:40:10 (GMT) |
| commit | 6cadc456decb76816d72a783232fa7f11552d260 (patch) | |
| tree | 21b3d6a2e895bf4c26a523096db589db1361fe3b /doc | |
| parent | e40bff6f47dac11999e68acb39cf27148eea0f44 (diff) | |
| download | tktreectrl-6cadc456decb76816d72a783232fa7f11552d260.zip tktreectrl-6cadc456decb76816d72a783232fa7f11552d260.tar.gz tktreectrl-6cadc456decb76816d72a783232fa7f11552d260.tar.bz2 | |
Updates for 2.2.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/What's New in TkTreeCtrl.html | 2750 | ||||
| -rw-r--r-- | doc/treectrl.html | 140 | ||||
| -rw-r--r-- | doc/treectrl.man | 134 | ||||
| -rw-r--r-- | doc/treectrl.n | 140 |
4 files changed, 2943 insertions, 221 deletions
diff --git a/doc/What's New in TkTreeCtrl.html b/doc/What's New in TkTreeCtrl.html index 9b9e04e..4fc90c5 100644 --- a/doc/What's New in TkTreeCtrl.html +++ b/doc/What's New in TkTreeCtrl.html @@ -1,7 +1,7 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
-<!-- $Id: What's\040New\040in\040TkTreeCtrl.html,v 1.18 2006/11/09 00:07:28 treectrl Exp $ -->
+<!-- $Id: What's\040New\040in\040TkTreeCtrl.html,v 1.19 2006/11/18 04:40:10 treectrl Exp $ -->
@@ -10,6 +10,12 @@ +
+
+
+
+
+
@@ -25,6 +31,9 @@ +
+
+
@@ -41,6 +50,12 @@ +
+
+
+
+
+
<title>What's New in TkTreeCtrl</title>
<meta content="Tim Baker" name="author">
</head>
@@ -55,6 +70,9 @@ +
+
+
<h1>What's New in TkTreeCtrl 2.2</h1>
@@ -64,6 +82,9 @@ +
+
+
<h2>TreeCtrl Configuration Options</h2>
@@ -80,6 +101,9 @@ +
+
+
@@ -90,8 +114,14 @@ <table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
<tbody>
+
+
+
<tr>
@@ -101,6 +131,9 @@ +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Deprecated</th>
@@ -110,6 +143,9 @@ +
+
+
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
@@ -121,6 +157,9 @@ instead</th> +
+
+
</tr>
@@ -130,6 +169,9 @@ instead</th> +
+
+
<tr>
@@ -139,6 +181,9 @@ instead</th> +
+
+
<td>-defaultstyle</td>
@@ -148,10 +193,22 @@ instead</th> +
+
+
<td>The -itemstyle option of a column.</td>
+
+
+
</tr>
+
+
+
+
+
+
</tbody>
</table>
@@ -163,6 +220,9 @@ instead</th> +
+
+
<h2>TreeCtrl Command</h2>
@@ -180,6 +240,9 @@ instead</th> +
+
+
@@ -190,7 +253,13 @@ instead</th> <table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
<tbody>
+
+
+
<tr>
@@ -200,6 +269,9 @@ instead</th> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
@@ -210,6 +282,9 @@ Changed</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
@@ -220,6 +295,9 @@ changed</th> +
+
+
</tr>
@@ -229,6 +307,9 @@ changed</th> +
+
+
<tr>
@@ -238,6 +319,9 @@ changed</th> +
+
+
<td>contentbox</td>
@@ -247,10 +331,28 @@ changed</th> - <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>
+
+
+
+ <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>
+
+
+
+
+
+
</tbody>
</table>
+
+
+
<h2>Column Configuration Options</h2>
@@ -260,6 +362,9 @@ changed</th> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -269,6 +374,9 @@ changed</th> +
+
+
<tbody>
@@ -278,6 +386,9 @@ changed</th> +
+
+
<tr>
@@ -287,6 +398,9 @@ changed</th> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Renamed<br>
@@ -296,6 +410,9 @@ changed</th> +
+
+
</th>
@@ -305,6 +422,9 @@ changed</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">New
name</th>
@@ -315,6 +435,9 @@ name</th> +
+
+
</tr>
@@ -324,6 +447,9 @@ name</th> +
+
+
<tr>
@@ -333,6 +459,9 @@ name</th> +
+
+
<td>-tag</td>
@@ -342,6 +471,9 @@ name</th> +
+
+
<td>-tags</td>
@@ -351,6 +483,9 @@ name</th> +
+
+
</tr>
@@ -360,6 +495,9 @@ name</th> +
+
+
<tr>
@@ -369,6 +507,9 @@ name</th> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
@@ -378,6 +519,9 @@ name</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">Comment</th>
@@ -387,6 +531,9 @@ name</th> +
+
+
</tr>
@@ -396,6 +543,9 @@ name</th> +
+
+
<tr>
@@ -405,6 +555,9 @@ name</th> +
+
+
<td>-lock</td>
@@ -414,6 +567,9 @@ name</th> +
+
+
<td>This option allows columns to stick to the left or
right edge
of the window. Locked columns can scroll vertically but not
@@ -426,6 +582,9 @@ horizontally. Valid values for this option are <span style="font-weight: bold;"> +
+
+
</tr>
@@ -435,16 +594,31 @@ horizontally. Valid values for this option are <span style="font-weight: bold;"> +
+
+
<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>
@@ -454,6 +628,9 @@ newly-created items. This option replaces the treectrl option +
+
+
<td>-uniform</td>
@@ -463,6 +640,9 @@ newly-created items. This option replaces the treectrl option +
+
+
<td colspan="1" rowspan="2">These two options
operate the same as the grid geometry manager options of the same name.
For example:<br>
@@ -474,6 +654,12 @@ For example:<br> +
+
+
+
+
+
@@ -490,6 +676,9 @@ For example:<br> +
+
+
will give columns 0 and 1 the same requested width, whichever is the larger of the two columns. And:<br>
@@ -498,6 +687,12 @@ will give columns 0 and 1 the same requested width, whichever is the larger of t +
+
+
+
+
+
@@ -513,6 +708,9 @@ will give columns 0 and 1 the same requested width, whichever is the larger of t +
+
+
will give column 0 twice the maximum of the requested widths of columns 0 and 1. And:<br>
@@ -520,6 +718,12 @@ will give column 0 twice the maximum of the requested widths of columns 0 and 1. +
+
+
+
+
+
@@ -533,6 +737,9 @@ will give column 0 twice the maximum of the requested widths of columns 0 and 1. +
+
+
will give column 0 twice the extra space as column 1.</td>
@@ -542,6 +749,9 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
</tr>
@@ -551,6 +761,9 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
<tr>
@@ -560,6 +773,9 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
<td>-weight</td>
@@ -569,6 +785,9 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
</tr>
@@ -578,6 +797,12 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
+
+
+
@@ -595,6 +820,9 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
<h2>Column Command</h2>
@@ -604,6 +832,9 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -613,6 +844,9 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
<tbody>
@@ -622,7 +856,34 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
<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
+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>
+
+
+
@@ -640,6 +901,9 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
<th style="background-color: rgb(204, 255, 255);">Comment</th>
@@ -649,6 +913,9 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
</tr>
@@ -658,6 +925,9 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
<tr>
@@ -667,6 +937,9 @@ will give column 0 twice the extra space as column 1.</td> +
+
+
<td>column tag add</td>
@@ -676,6 +949,9 @@ will give column 0 twice the extra space as column 1.</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
@@ -688,6 +964,9 @@ word "tail" in column descriptions. </td> +
+
+
</tr>
@@ -697,6 +976,9 @@ word "tail" in column descriptions. </td> +
+
+
<tr>
@@ -706,6 +988,9 @@ word "tail" in column descriptions. </td> +
+
+
<td>column tag expr</td>
@@ -715,6 +1000,9 @@ word "tail" in column descriptions. </td> +
+
+
</tr>
@@ -724,6 +1012,9 @@ word "tail" in column descriptions. </td> +
+
+
<tr>
@@ -733,6 +1024,9 @@ word "tail" in column descriptions. </td> +
+
+
<td>column tag names</td>
@@ -742,6 +1036,9 @@ word "tail" in column descriptions. </td> +
+
+
</tr>
@@ -751,6 +1048,9 @@ word "tail" in column descriptions. </td> +
+
+
<tr>
@@ -760,6 +1060,9 @@ word "tail" in column descriptions. </td> +
+
+
<td>column tag remove</td>
@@ -769,6 +1072,9 @@ word "tail" in column descriptions. </td> +
+
+
</tr>
@@ -778,6 +1084,12 @@ word "tail" in column descriptions. </td> +
+
+
+
+
+
@@ -795,6 +1107,9 @@ word "tail" in column descriptions. </td> +
+
+
<h2>Item Configuration Options</h2>
@@ -804,6 +1119,9 @@ word "tail" in column descriptions. </td> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -813,6 +1131,9 @@ word "tail" in column descriptions. </td> +
+
+
<tbody>
@@ -822,6 +1143,9 @@ word "tail" in column descriptions. </td> +
+
+
<tr>
@@ -831,6 +1155,9 @@ word "tail" in column descriptions. </td> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
@@ -840,6 +1167,9 @@ word "tail" in column descriptions. </td> +
+
+
<th style="background-color: rgb(204, 255, 255);">Comment</th>
@@ -849,6 +1179,9 @@ word "tail" in column descriptions. </td> +
+
+
</tr>
@@ -858,6 +1191,9 @@ word "tail" in column descriptions. </td> +
+
+
<tr>
@@ -867,6 +1203,9 @@ word "tail" in column descriptions. </td> +
+
+
<td>-tags</td>
@@ -876,6 +1215,9 @@ word "tail" in column descriptions. </td> +
+
+
<td>
@@ -894,6 +1236,9 @@ found in the <a href="treectrl.html#item_tags">man page</a>.</td> +
+
+
</tr>
@@ -903,6 +1248,12 @@ found in the <a href="treectrl.html#item_tags">man page</a>.</td> +
+
+
+
+
+
@@ -920,6 +1271,9 @@ found in the <a href="treectrl.html#item_tags">man page</a>.</td> +
+
+
<h2>Item Command</h2>
@@ -929,6 +1283,9 @@ found in the <a href="treectrl.html#item_tags">man page</a>.</td> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -938,6 +1295,9 @@ found in the <a href="treectrl.html#item_tags">man page</a>.</td> +
+
+
<tbody>
@@ -947,6 +1307,9 @@ found in the <a href="treectrl.html#item_tags">man page</a>.</td> +
+
+
<tr>
@@ -956,6 +1319,9 @@ found in the <a href="treectrl.html#item_tags">man page</a>.</td> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
@@ -966,6 +1332,9 @@ Changed</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
@@ -976,6 +1345,9 @@ changed</th> +
+
+
</tr>
@@ -985,6 +1357,9 @@ changed</th> +
+
+
<tr>
@@ -994,6 +1369,9 @@ changed</th> +
+
+
<td>item count</td>
@@ -1003,9 +1381,24 @@ changed</th> - <td>New option <span style="font-weight: bold;">-visible</span>
-added to return the number of items that are displayed (i.e., those
-whose ancestors are all expanded etc).</td>
+
+
+
+ <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>
+
+
+
@@ -1023,6 +1416,9 @@ whose ancestors are all expanded etc).</td> +
+
+
<tr>
@@ -1032,6 +1428,9 @@ whose ancestors are all expanded etc).</td> +
+
+
<td>item create</td>
@@ -1041,6 +1440,9 @@ whose ancestors are all expanded etc).</td> +
+
+
<td>New option <span style="font-weight: bold;">-tags</span>
specifies an initial list of tags for created items.</td>
@@ -1051,6 +1453,9 @@ specifies an initial list of tags for created items.</td> +
+
+
</tr>
@@ -1060,6 +1465,9 @@ specifies an initial list of tags for created items.</td> +
+
+
<tr>
@@ -1069,6 +1477,9 @@ specifies an initial list of tags for created items.</td> +
+
+
<td>item id</td>
@@ -1078,6 +1489,9 @@ specifies an initial list of tags for created items.</td> +
+
+
<td>Returns a list of item ids if the item description
matches multiple items. For example:<br>
@@ -1088,6 +1502,12 @@ matches multiple items. For example:<br> +
+
+
+
+
+
@@ -1104,6 +1524,9 @@ matches multiple items. For example:<br> +
+
+
will return a list of ids for all items, and:<br>
@@ -1113,6 +1536,12 @@ will return a list of ids for all items, and:<br> +
+
+
+
+
+
@@ -1129,6 +1558,9 @@ will return a list of ids for all items, and:<br> +
+
+
will return the ids of every child of an item.</td>
@@ -1138,6 +1570,9 @@ will return the ids of every child of an item.</td> +
+
+
</tr>
@@ -1147,6 +1582,9 @@ will return the ids of every child of an item.</td> +
+
+
<tr>
@@ -1156,6 +1594,9 @@ will return the ids of every child of an item.</td> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
@@ -1165,6 +1606,9 @@ will return the ids of every child of an item.</td> +
+
+
<th style="background-color: rgb(204, 255, 255);">Comment</th>
@@ -1174,6 +1618,9 @@ will return the ids of every child of an item.</td> +
+
+
</tr>
@@ -1183,6 +1630,9 @@ will return the ids of every child of an item.</td> +
+
+
<tr>
@@ -1192,6 +1642,9 @@ will return the ids of every child of an item.</td> +
+
+
<td>item descendants</td>
@@ -1201,6 +1654,9 @@ will return the ids of every child of an item.</td> +
+
+
<td>Returns the ids of the children, grandchildren, etc of
an item.</td>
@@ -1211,6 +1667,9 @@ an item.</td> +
+
+
</tr>
@@ -1220,6 +1679,9 @@ an item.</td> +
+
+
<tr>
@@ -1229,6 +1691,9 @@ an item.</td> +
+
+
<td>item enabled</td>
@@ -1238,6 +1703,9 @@ an item.</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
@@ -1250,6 +1718,9 @@ and mouse bindings.</td> +
+
+
</tr>
@@ -1259,6 +1730,9 @@ and mouse bindings.</td> +
+
+
<tr>
@@ -1268,6 +1742,9 @@ and mouse bindings.</td> +
+
+
<td>item tag add</td>
@@ -1277,6 +1754,9 @@ and mouse bindings.</td> +
+
+
<td>Add tags to items. For example:<br>
@@ -1286,6 +1766,12 @@ and mouse bindings.</td> +
+
+
+
+
+
@@ -1302,6 +1788,9 @@ and mouse bindings.</td> +
+
+
will add tags "a", "b" and "c" to every item.<br>
@@ -1311,6 +1800,9 @@ will add tags "a", "b" and "c" to every item.<br> +
+
+
</td>
@@ -1320,6 +1812,9 @@ will add tags "a", "b" and "c" to every item.<br> +
+
+
</tr>
@@ -1329,6 +1824,9 @@ will add tags "a", "b" and "c" to every item.<br> +
+
+
<tr>
@@ -1338,6 +1836,9 @@ will add tags "a", "b" and "c" to every item.<br> +
+
+
<td>item tag expr</td>
@@ -1347,6 +1848,9 @@ will add tags "a", "b" and "c" to every item.<br> +
+
+
<td>Evaluate a tag expression against items. For example:<br>
@@ -1356,6 +1860,12 @@ will add tags "a", "b" and "c" to every item.<br> +
+
+
+
+
+
@@ -1372,6 +1882,9 @@ will add tags "a", "b" and "c" to every item.<br> +
+
+
returns 1 if an item has tag "a". Also:<br>
@@ -1381,6 +1894,12 @@ returns 1 if an item has tag "a". Also:<br> +
+
+
+
+
+
@@ -1397,6 +1916,9 @@ returns 1 if an item has tag "a". Also:<br> +
+
+
returns 1 if an item has tag "a" or "b".</td>
@@ -1406,6 +1928,9 @@ returns 1 if an item has tag "a" or "b".</td> +
+
+
</tr>
@@ -1415,6 +1940,9 @@ returns 1 if an item has tag "a" or "b".</td> +
+
+
<tr>
@@ -1424,6 +1952,9 @@ returns 1 if an item has tag "a" or "b".</td> +
+
+
<td>item tag names</td>
@@ -1433,6 +1964,9 @@ returns 1 if an item has tag "a" or "b".</td> +
+
+
<td>Return a list of tag names assigned to items. For
example:<br>
@@ -1443,6 +1977,12 @@ example:<br> +
+
+
+
+
+
@@ -1459,6 +1999,9 @@ example:<br> +
+
+
returns the tag list for an item, and:<br>
@@ -1468,6 +2011,12 @@ returns the tag list for an item, and:<br> +
+
+
+
+
+
@@ -1484,6 +2033,9 @@ returns the tag list for an item, and:<br> +
+
+
returns every tag assigned to any item.</td>
@@ -1493,6 +2045,9 @@ returns every tag assigned to any item.</td> +
+
+
</tr>
@@ -1502,6 +2057,9 @@ returns every tag assigned to any item.</td> +
+
+
<tr>
@@ -1511,6 +2069,9 @@ returns every tag assigned to any item.</td> +
+
+
<td>item tag remove</td>
@@ -1520,6 +2081,9 @@ returns every tag assigned to any item.</td> +
+
+
<td>Remove tags from items. For example:<br>
@@ -1529,6 +2093,12 @@ returns every tag assigned to any item.</td> +
+
+
+
+
+
@@ -1545,6 +2115,9 @@ returns every tag assigned to any item.</td> +
+
+
will remove tags "b" and "c" from any items that have them.</td>
@@ -1554,6 +2127,9 @@ will remove tags "b" and "c" from any items that have them.</td> +
+
+
</tr>
@@ -1563,6 +2139,12 @@ will remove tags "b" and "c" from any items that have them.</td> +
+
+
+
+
+
@@ -1573,8 +2155,14 @@ will remove tags "b" and "c" from any items that have them.</td> </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>
@@ -1584,6 +2172,9 @@ The new option <span style="font-weight: bold;">-underline</span> draws an under +
+
+
<h2>Window Element</h2>
@@ -1593,6 +2184,9 @@ The new option <span style="font-weight: bold;">-underline</span> draws an under +
+
+
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
@@ -1607,6 +2201,9 @@ 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>
@@ -1616,6 +2213,9 @@ a window element, you would change this code:<br> +
+
+
to this:<br>
@@ -1625,6 +2225,9 @@ 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>
@@ -1634,6 +2237,9 @@ to this:<br> +
+
+
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,
@@ -1650,6 +2256,9 @@ demos. +
+
+
New keywords were added to allow multiple items to be specified by an <a href="treectrl.html#item_description">item description</a>:<br>
@@ -1659,6 +2268,9 @@ New keywords were added to allow multiple items to be specified by an <a href="t +
+
+
<ul>
@@ -1668,6 +2280,9 @@ New keywords were added to allow multiple items to be specified by an <a href="t +
+
+
<li>The keyword <span style="font-weight: bold;">list</span>
specifies a list of other item descriptions:
@@ -1677,6 +2292,9 @@ specifies a list of other item descriptions: +
+
+
<pre>.t item id "list [list $a $b $c]"</pre>
@@ -1686,6 +2304,9 @@ specifies a list of other item descriptions: +
+
+
</li>
@@ -1695,6 +2316,9 @@ specifies a list of other item descriptions: +
+
+
<li>The keyword <span style="font-weight: bold;">range</span>
operates like the <span style="font-weight: bold;">item
range</span> command:
@@ -1705,6 +2329,9 @@ range</span> command: +
+
+
<pre>.t item id "range $first $last"</pre>
@@ -1714,16 +2341,25 @@ range</span> command: +
+
+
</li>
+
+
+
</ul>
+
+
+
New modifiers were added to match multiple items:
<ul>
@@ -1734,6 +2370,9 @@ New modifiers were added to match multiple items: +
+
+
<li>The modifier <span style="font-weight: bold;">ancestors</span>
operates like the <span style="font-weight: bold;">item
ancestors</span> command:
@@ -1744,6 +2383,9 @@ ancestors</span> command: +
+
+
<pre>.t item id "$item ancestors"</pre>
@@ -1753,6 +2395,9 @@ ancestors</span> command: +
+
+
</li>
@@ -1762,6 +2407,9 @@ ancestors</span> command: +
+
+
<li>The modifier <span style="font-weight: bold;">children</span>
operates like the <span style="font-weight: bold;">item
children</span> command:
@@ -1772,6 +2420,9 @@ children</span> command: +
+
+
<pre>.t item id "$item children"</pre>
@@ -1781,6 +2432,9 @@ children</span> command: +
+
+
</li>
@@ -1790,6 +2444,9 @@ children</span> command: +
+
+
<li>The modifier <span style="font-weight: bold;">descendants</span>
operates like the <span style="font-weight: bold;">item
descendants</span> command:
@@ -1800,6 +2457,9 @@ descendants</span> command: +
+
+
<pre>.t item id "$item descendants"</pre>
@@ -1809,6 +2469,9 @@ descendants</span> command: +
+
+
</li>
@@ -1818,6 +2481,9 @@ descendants</span> command: +
+
+
</ul>
@@ -1827,6 +2493,9 @@ descendants</span> command: +
+
+
New qualifiers were added to refine which items are matched:<br>
@@ -1836,6 +2505,9 @@ New qualifiers were added to refine which items are matched:<br> +
+
+
<ul>
@@ -1845,18 +2517,27 @@ New qualifiers were added to refine which items are matched:<br> +
+
+
<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>
@@ -1864,18 +2545,27 @@ New qualifiers were added to refine which items are matched:<br> +
+
+
</div>
+
+
+
<ul>
+
+
+
<li>The qualifier <span style="font-weight: bold;">!visible</span>
matches items that are not displayed:
@@ -1885,6 +2575,9 @@ matches items that are not displayed: +
+
+
<pre>.t item id "first !visible" ; # find the first item that is not displayed</pre>
@@ -1894,6 +2587,9 @@ matches items that are not displayed: +
+
+
</li>
@@ -1903,6 +2599,9 @@ matches items that are not displayed: +
+
+
<li>The qualifier <span style="font-weight: bold;">state</span>
matches items that have certain states set (or not set if '!' is used):
@@ -1912,6 +2611,9 @@ 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>
@@ -1921,6 +2623,9 @@ matches items that have certain states set (or not set if '!' is used): +
+
+
</li>
@@ -1930,6 +2635,9 @@ matches items that have certain states set (or not set if '!' is used): +
+
+
<li>The qualifier <span style="font-weight: bold;">tag</span>
matches items that meet a tag expression:
@@ -1939,6 +2647,9 @@ 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>
@@ -1948,6 +2659,9 @@ matches items that meet a tag expression: +
+
+
</li>
@@ -1957,16 +2671,25 @@ matches items that meet a tag expression: +
+
+
</ul>
+
+
+
<br>
+
+
+
The keyword <span style="font-weight: bold;">all</span>
may now be followed by a list of qualifiers. For example:<br>
@@ -1977,11 +2700,17 @@ 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
qualifiers. For example:<br>
@@ -1989,17 +2718,26 @@ 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>
@@ -2009,6 +2747,9 @@ qualifiers. For example:<br> +
+
+
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>
@@ -2016,6 +2757,9 @@ 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>
@@ -2023,11 +2767,17 @@ 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>
+
+
+
A list of qualifiers may used as the first part of a column
description. This gives the same result as "all" followed by the
qualifiers.
@@ -2036,11 +2786,17 @@ qualifiers. +
+
+
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 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>
+<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>
+
+
+
@@ -2050,6 +2806,9 @@ For example: +
+
+
<h2>Demo Changes</h2>
@@ -2059,6 +2818,9 @@ For example: +
+
+
<ul>
@@ -2068,6 +2830,9 @@ For example: +
+
+
<li>New demo "My Computer". Demonstrates disabled items used as
headers.</li>
@@ -2078,6 +2843,9 @@ headers.</li> +
+
+
<li>New demo "Column Locking". Demonstrates columns that do not
scroll horizontally.</li>
@@ -2088,6 +2856,9 @@ 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>
@@ -2099,6 +2870,29 @@ 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 <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>Memory usage is improved, especially for text elements.</li>
+
+
</ul>
@@ -2108,6 +2902,9 @@ option of window elements.</li> +
+
+
<h2>Bug Fixes</h2>
@@ -2117,6 +2914,9 @@ option of window elements.</li> +
+
+
<ul>
@@ -2126,6 +2926,9 @@ option of window elements.</li> +
+
+
<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>
@@ -2138,6 +2941,9 @@ 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>
@@ -2150,6 +2956,9 @@ 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>
@@ -2158,6 +2967,9 @@ binding scripts.</li> +
+
+
<li>Fixed a crash and a redisplay problem when a master element was
configured with a -textvariable and the associated variable changed.</li>
@@ -2168,6 +2980,9 @@ 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>
@@ -2178,10 +2993,19 @@ 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>
+
+
+
+
+
@@ -2197,6 +3021,9 @@ columns or items were hidden, or if the span of an item-column changed.</li> +
+
+
<hr style="width: 100%; height: 2px;">
<h1>What's New in TkTreeCtrl 2.1.1</h1>
@@ -2207,6 +3034,9 @@ columns or items were hidden, or if the span of an item-column changed.</li> +
+
+
<h2>Column Command</h2>
@@ -2216,6 +3046,9 @@ columns or items were hidden, or if the span of an item-column changed.</li> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -2225,6 +3058,9 @@ columns or items were hidden, or if the span of an item-column changed.</li> +
+
+
<tbody>
@@ -2234,6 +3070,9 @@ columns or items were hidden, or if the span of an item-column changed.</li> +
+
+
<tr>
@@ -2243,6 +3082,9 @@ columns or items were hidden, or if the span of an item-column changed.</li> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
@@ -2253,6 +3095,9 @@ Changed</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
@@ -2263,6 +3108,9 @@ changed</th> +
+
+
</tr>
@@ -2272,6 +3120,9 @@ changed</th> +
+
+
<tr>
@@ -2281,6 +3132,9 @@ changed</th> +
+
+
<td>column delete<br>
@@ -2290,6 +3144,9 @@ changed</th> +
+
+
</td>
@@ -2299,6 +3156,9 @@ changed</th> +
+
+
<td>Added an optional second argument allowing a range of
columns to be deleted.</td>
@@ -2309,6 +3169,9 @@ columns to be deleted.</td> +
+
+
</tr>
@@ -2318,6 +3181,12 @@ columns to be deleted.</td> +
+
+
+
+
+
@@ -2335,6 +3204,9 @@ columns to be deleted.</td> +
+
+
<h2>Bug Fixes</h2>
@@ -2344,6 +3216,9 @@ columns to be deleted.</td> +
+
+
<ul>
@@ -2353,6 +3228,9 @@ columns to be deleted.</td> +
+
+
<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
@@ -2365,6 +3243,9 @@ 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>
@@ -2375,6 +3256,9 @@ the header is altered.</li> +
+
+
<li>Fixed bus errors on some Unix systems due to alignment
problems.</li>
@@ -2385,6 +3269,9 @@ problems.</li> +
+
+
</ul>
@@ -2394,6 +3281,9 @@ problems.</li> +
+
+
<h2>Other Changes</h2>
@@ -2403,6 +3293,9 @@ problems.</li> +
+
+
<ul>
@@ -2412,6 +3305,9 @@ problems.</li> +
+
+
<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>
@@ -2423,6 +3319,9 @@ application and IME on Windows, as well as XIM under Unix.</li> +
+
+
<li>Improved the appearance of the column headers under OSX.</li>
@@ -2432,6 +3331,9 @@ application and IME on Windows, as well as XIM under Unix.</li> +
+
+
<li>Added <MouseWheel> support to OSX.</li>
@@ -2441,6 +3343,9 @@ application and IME on Windows, as well as XIM under Unix.</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
@@ -2455,6 +3360,9 @@ the next display update.</li> +
+
+
</ul>
@@ -2464,6 +3372,9 @@ the next display update.</li> +
+
+
<h2>Demo Changes</h2>
@@ -2473,6 +3384,9 @@ the next display update.</li> +
+
+
<ul>
@@ -2482,6 +3396,9 @@ the next display update.</li> +
+
+
<li>New demo "Column Spanning". Demonstrates a 100-column list
where styles span from 1 to 20 columns each.</li>
@@ -2492,6 +3409,9 @@ 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>
@@ -2503,6 +3423,9 @@ on Windows and OSX thanks to Jeff Hobbs.</li> +
+
+
<li>The screen-magnifier image now resizes with the "loupe"
window.</li>
@@ -2513,6 +3436,9 @@ window.</li> +
+
+
</ul>
@@ -2522,6 +3448,9 @@ window.</li> +
+
+
<hr style="width: 100%; height: 2px;">
<h1>What's New in TkTreeCtrl 2.1</h1>
@@ -2532,6 +3461,9 @@ window.</li> +
+
+
This version should be backwards compatible with 2.0, except for a few
obscure changes.<br>
@@ -2542,6 +3474,9 @@ obscure changes.<br> +
+
+
<h2>TreeCtrl Configuration Options</h2>
@@ -2551,6 +3486,9 @@ obscure changes.<br> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -2560,6 +3498,9 @@ obscure changes.<br> +
+
+
<tbody>
@@ -2569,6 +3510,9 @@ obscure changes.<br> +
+
+
<tr>
@@ -2578,6 +3522,9 @@ obscure changes.<br> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
@@ -2587,6 +3534,9 @@ obscure changes.<br> +
+
+
<th style="background-color: rgb(204, 255, 255);">Comment</th>
@@ -2596,6 +3546,9 @@ obscure changes.<br> +
+
+
</tr>
@@ -2605,6 +3558,9 @@ obscure changes.<br> +
+
+
<tr>
@@ -2614,6 +3570,9 @@ obscure changes.<br> +
+
+
<td>-itemwidth</td>
@@ -2623,6 +3582,9 @@ obscure changes.<br> +
+
+
<td><br>
@@ -2632,6 +3594,9 @@ obscure changes.<br> +
+
+
</td>
@@ -2641,6 +3606,9 @@ obscure changes.<br> +
+
+
</tr>
@@ -2650,6 +3618,9 @@ obscure changes.<br> +
+
+
<tr>
@@ -2659,6 +3630,9 @@ obscure changes.<br> +
+
+
<td>-itemwidthequal</td>
@@ -2668,6 +3642,9 @@ obscure changes.<br> +
+
+
<td>Deprecates the column -widthhack option.</td>
@@ -2677,6 +3654,9 @@ obscure changes.<br> +
+
+
</tr>
@@ -2686,6 +3666,9 @@ obscure changes.<br> +
+
+
<tr>
@@ -2695,6 +3678,9 @@ obscure changes.<br> +
+
+
<td>-itemwidthmultiple</td>
@@ -2704,6 +3690,9 @@ obscure changes.<br> +
+
+
<td>Deprecates the column -stepwidth option.</td>
@@ -2713,6 +3702,9 @@ obscure changes.<br> +
+
+
</tr>
@@ -2722,6 +3714,12 @@ obscure changes.<br> +
+
+
+
+
+
@@ -2739,6 +3737,9 @@ obscure changes.<br> +
+
+
<h2>Column Configuration Options</h2>
@@ -2748,6 +3749,9 @@ obscure changes.<br> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -2757,6 +3761,9 @@ obscure changes.<br> +
+
+
<tbody>
@@ -2766,6 +3773,9 @@ obscure changes.<br> +
+
+
<tr>
@@ -2775,6 +3785,9 @@ obscure changes.<br> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Deprecated</th>
@@ -2784,6 +3797,9 @@ obscure changes.<br> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
@@ -2795,6 +3811,9 @@ instead</th> +
+
+
</tr>
@@ -2804,6 +3823,9 @@ instead</th> +
+
+
<tr>
@@ -2813,6 +3835,9 @@ instead</th> +
+
+
<td>-stepwidth</td>
@@ -2822,6 +3847,9 @@ instead</th> +
+
+
<td>treectrl's -itemwidthmultiple option</td>
@@ -2831,6 +3859,9 @@ instead</th> +
+
+
</tr>
@@ -2840,6 +3871,9 @@ instead</th> +
+
+
<tr>
@@ -2849,6 +3883,9 @@ instead</th> +
+
+
<td>-widthhack</td>
@@ -2858,6 +3895,9 @@ instead</th> +
+
+
<td>treectrl's -itemwidthequal option</td>
@@ -2867,6 +3907,9 @@ instead</th> +
+
+
</tr>
@@ -2876,6 +3919,12 @@ instead</th> +
+
+
+
+
+
@@ -2893,6 +3942,9 @@ instead</th> +
+
+
<h2>Element Command</h2>
@@ -2902,6 +3954,9 @@ instead</th> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -2911,6 +3966,9 @@ instead</th> +
+
+
<tbody>
@@ -2920,6 +3978,9 @@ instead</th> +
+
+
<tr>
@@ -2929,6 +3990,9 @@ instead</th> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
@@ -2938,6 +4002,9 @@ instead</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">Comment</th>
@@ -2947,6 +4014,9 @@ instead</th> +
+
+
</tr>
@@ -2956,6 +4026,9 @@ instead</th> +
+
+
<tr>
@@ -2965,6 +4038,9 @@ instead</th> +
+
+
<td>element perstate</td>
@@ -2974,6 +4050,9 @@ instead</th> +
+
+
<td>Like [item element perstate].</td>
@@ -2983,6 +4062,9 @@ instead</th> +
+
+
</tr>
@@ -2992,6 +4074,12 @@ instead</th> +
+
+
+
+
+
@@ -3009,6 +4097,9 @@ instead</th> +
+
+
<h2>Item Configuration Options</h2>
@@ -3018,6 +4109,9 @@ instead</th> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -3027,6 +4121,9 @@ instead</th> +
+
+
<tbody>
@@ -3036,6 +4133,9 @@ instead</th> +
+
+
<tr>
@@ -3045,6 +4145,9 @@ instead</th> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
@@ -3054,6 +4157,9 @@ instead</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">Comment</th>
@@ -3063,6 +4169,9 @@ instead</th> +
+
+
</tr>
@@ -3072,6 +4181,9 @@ instead</th> +
+
+
<tr>
@@ -3081,6 +4193,9 @@ instead</th> +
+
+
<td>-height</td>
@@ -3090,6 +4205,9 @@ instead</th> +
+
+
<td>Overrides the treectrl's -itemheight option</td>
@@ -3099,6 +4217,9 @@ instead</th> +
+
+
</tr>
@@ -3108,6 +4229,12 @@ instead</th> +
+
+
+
+
+
@@ -3125,6 +4252,9 @@ instead</th> +
+
+
<h2>Item Command</h2>
@@ -3134,6 +4264,9 @@ instead</th> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -3143,6 +4276,9 @@ instead</th> +
+
+
<tbody>
@@ -3152,6 +4288,9 @@ instead</th> +
+
+
<tr>
@@ -3161,6 +4300,9 @@ instead</th> +
+
+
<th style="background-color: rgb(255, 255, 204);">Deprecated</th>
@@ -3170,6 +4312,9 @@ instead</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
@@ -3181,6 +4326,9 @@ instead</th> +
+
+
</tr>
@@ -3190,6 +4338,9 @@ instead</th> +
+
+
<tr>
@@ -3199,6 +4350,9 @@ instead</th> +
+
+
<td>item element actual</td>
@@ -3208,6 +4362,9 @@ instead</th> +
+
+
<td>item element perstate</td>
@@ -3217,6 +4374,9 @@ instead</th> +
+
+
</tr>
@@ -3226,6 +4386,9 @@ instead</th> +
+
+
<tr>
@@ -3235,6 +4398,9 @@ instead</th> +
+
+
<td>item complex</td>
@@ -3244,6 +4410,9 @@ instead</th> +
+
+
<td>item element configure</td>
@@ -3253,6 +4422,9 @@ instead</th> +
+
+
</tr>
@@ -3262,6 +4434,9 @@ instead</th> +
+
+
<tr>
@@ -3271,6 +4446,9 @@ instead</th> +
+
+
<th style="background-color: rgb(255, 255, 204);">Behaviour
Changed</th>
@@ -3281,6 +4459,9 @@ Changed</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
@@ -3291,6 +4472,9 @@ changed</th> +
+
+
</tr>
@@ -3300,6 +4484,9 @@ changed</th> +
+
+
<tr>
@@ -3309,6 +4496,9 @@ changed</th> +
+
+
<td>item bbox</td>
@@ -3318,6 +4508,9 @@ changed</th> +
+
+
<td>No longer returns an error if no style had been
assigned to the column.</td>
@@ -3328,6 +4521,9 @@ assigned to the column.</td> +
+
+
</tr>
@@ -3337,6 +4533,9 @@ assigned to the column.</td> +
+
+
<tr>
@@ -3346,6 +4545,9 @@ assigned to the column.</td> +
+
+
<td>item state forcolumn</td>
@@ -3355,6 +4557,9 @@ assigned to the column.</td> +
+
+
<td>No longer returns an error if no style had been
assigned to the column.</td>
@@ -3365,6 +4570,9 @@ assigned to the column.</td> +
+
+
</tr>
@@ -3374,6 +4582,9 @@ assigned to the column.</td> +
+
+
<tr>
@@ -3383,6 +4594,9 @@ assigned to the column.</td> +
+
+
<td>item style set</td>
@@ -3392,6 +4606,9 @@ assigned to the column.</td> +
+
+
<td>Does nothing when replacing a style with the same
style.
Previously the old style was freed before assigning the new style,
@@ -3404,6 +4621,9 @@ 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>
@@ -3414,6 +4634,9 @@ incompatibility</span></td> +
+
+
</tr>
@@ -3423,6 +4646,9 @@ incompatibility</span></td> +
+
+
<tr>
@@ -3432,6 +4658,9 @@ incompatibility</span></td> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
@@ -3442,6 +4671,9 @@ Changed</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
@@ -3452,6 +4684,9 @@ changed</th> +
+
+
</tr>
@@ -3461,6 +4696,9 @@ changed</th> +
+
+
<tr>
@@ -3470,6 +4708,9 @@ changed</th> +
+
+
<td>item create</td>
@@ -3479,6 +4720,9 @@ changed</th> +
+
+
<td>Added options: -count -height, -nextsibling, -open,
-parent,
-prevsibling, and -returnid. Multiple items may be created with one
@@ -3491,6 +4735,9 @@ call using the -count option.</td> +
+
+
</tr>
@@ -3500,6 +4747,9 @@ call using the -count option.</td> +
+
+
<tr>
@@ -3509,6 +4759,9 @@ call using the -count option.</td> +
+
+
<td>item element configure</td>
@@ -3518,6 +4771,9 @@ call using the -count option.</td> +
+
+
<td>Multiple elements in multiple columns may be configured
with
a single call. Use '+' to separate elements, and ',' to separate
@@ -3530,6 +4786,9 @@ columns. See the docs.</td> +
+
+
</tr>
@@ -3539,6 +4798,9 @@ columns. See the docs.</td> +
+
+
<tr>
@@ -3548,6 +4810,9 @@ columns. See the docs.</td> +
+
+
<td>item style set</td>
@@ -3557,6 +4822,9 @@ columns. See the docs.</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
@@ -3570,6 +4838,9 @@ column(s).<br> +
+
+
<span style="color: rgb(255, 0, 0);">Potential
incompatibility</span></td>
@@ -3580,6 +4851,9 @@ incompatibility</span></td> +
+
+
</tr>
@@ -3589,6 +4863,9 @@ incompatibility</span></td> +
+
+
<tr>
@@ -3598,6 +4875,9 @@ incompatibility</span></td> +
+
+
<td>item text</td>
@@ -3607,6 +4887,9 @@ incompatibility</span></td> +
+
+
<td>When no column is specified, returns a list of one
string per column.</td>
@@ -3617,6 +4900,9 @@ string per column.</td> +
+
+
</tr>
@@ -3626,6 +4912,9 @@ string per column.</td> +
+
+
<tr>
@@ -3635,6 +4924,9 @@ string per column.</td> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
@@ -3644,6 +4936,9 @@ string per column.</td> +
+
+
<th style="background-color: rgb(204, 255, 255);">Comment</th>
@@ -3653,6 +4948,9 @@ string per column.</td> +
+
+
</tr>
@@ -3662,6 +4960,9 @@ string per column.</td> +
+
+
<tr>
@@ -3671,6 +4972,9 @@ string per column.</td> +
+
+
<td>item image</td>
@@ -3680,6 +4984,9 @@ string per column.</td> +
+
+
<td>Partner to the [item text] command.</td>
@@ -3689,6 +4996,9 @@ string per column.</td> +
+
+
</tr>
@@ -3698,6 +5008,9 @@ string per column.</td> +
+
+
<tr>
@@ -3707,6 +5020,9 @@ string per column.</td> +
+
+
<td>item element perstate</td>
@@ -3716,6 +5032,9 @@ string per column.</td> +
+
+
<td>Not really new, just renamed from [item element actual]
to
better describe what it does. Accepts a new optional argument which
@@ -3729,6 +5048,9 @@ option.<br> +
+
+
<br>
@@ -3738,6 +5060,9 @@ option.<br> +
+
+
The following options no longer return a default value if the per-state
option itself does not have a value specified:<br>
@@ -3748,6 +5073,12 @@ option itself does not have a value specified:<br> +
+
+
+
+
+
@@ -3764,6 +5095,9 @@ option itself does not have a value specified:<br> +
+
+
<li>bitmap -foreground, -background</li>
@@ -3773,6 +5107,9 @@ option itself does not have a value specified:<br> +
+
+
<li>border -relief</li>
@@ -3782,6 +5119,9 @@ option itself does not have a value specified:<br> +
+
+
<li>text -fill, -font</li>
@@ -3791,6 +5131,12 @@ option itself does not have a value specified:<br> +
+
+
+
+
+
@@ -3807,6 +5153,9 @@ option itself does not have a value specified:<br> +
+
+
<span style="color: rgb(255, 0, 0);">Potential
incompatibility</span></td>
@@ -3817,6 +5166,9 @@ incompatibility</span></td> +
+
+
</tr>
@@ -3826,6 +5178,9 @@ incompatibility</span></td> +
+
+
<tr>
@@ -3835,6 +5190,9 @@ incompatibility</span></td> +
+
+
<td>item span</td>
@@ -3844,6 +5202,9 @@ incompatibility</span></td> +
+
+
<td>A style may now be displayed over multiple adjacent
columns.<br>
@@ -3854,6 +5215,9 @@ columns.<br> +
+
+
</td>
@@ -3863,6 +5227,9 @@ columns.<br> +
+
+
</tr>
@@ -3872,6 +5239,12 @@ columns.<br> +
+
+
+
+
+
@@ -3889,6 +5262,9 @@ columns.<br> +
+
+
<h2><span style="font-weight: bold;"></span>Notify
Command</h2>
@@ -3899,6 +5275,9 @@ Command</h2> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -3908,6 +5287,9 @@ Command</h2> +
+
+
<tbody>
@@ -3917,6 +5299,9 @@ Command</h2> +
+
+
<tr>
@@ -3926,6 +5311,9 @@ Command</h2> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
@@ -3935,6 +5323,9 @@ Command</h2> +
+
+
<th style="background-color: rgb(204, 255, 255);">Comment</th>
@@ -3944,6 +5335,9 @@ Command</h2> +
+
+
</tr>
@@ -3953,6 +5347,9 @@ Command</h2> +
+
+
<tr>
@@ -3962,6 +5359,9 @@ Command</h2> +
+
+
<td>notify unbind<br>
@@ -3971,6 +5371,9 @@ Command</h2> +
+
+
</td>
@@ -3980,6 +5383,9 @@ Command</h2> +
+
+
<td>Let's you unbind all scripts from an object with one
call.</td>
@@ -3990,6 +5396,9 @@ call.</td> +
+
+
</tr>
@@ -3999,6 +5408,12 @@ call.</td> +
+
+
+
+
+
@@ -4016,6 +5431,9 @@ call.</td> +
+
+
<h2>Style Layout Changes</h2>
@@ -4025,6 +5443,9 @@ call.</td> +
+
+
<ul>
@@ -4034,6 +5455,9 @@ call.</td> +
+
+
<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>
@@ -4044,6 +5468,9 @@ elements in 2 situations which previously had no effect (<span style="color: rgb +
+
+
</ul>
@@ -4053,6 +5480,9 @@ elements in 2 situations which previously had no effect (<span style="color: rgb +
+
+
<ol style="margin-left: 40px;">
@@ -4062,6 +5492,9 @@ elements in 2 situations which previously had no effect (<span style="color: rgb +
+
+
<li>If a -detach element had a fixed width larger than the
other elements.</li>
@@ -4072,6 +5505,9 @@ other elements.</li> +
+
+
<li>If an element had -iexpand x specified as well as
-maxwidth, leaving some space available.</li>
@@ -4082,6 +5518,9 @@ other elements.</li> +
+
+
</ol>
@@ -4091,6 +5530,9 @@ other elements.</li> +
+
+
<h2>Element Changes</h2>
@@ -4100,6 +5542,9 @@ other elements.</li> +
+
+
<ul>
@@ -4109,6 +5554,9 @@ other elements.</li> +
+
+
<li>Bitmap, image and text elements are drawn clipped if given
less space than they need.</li>
@@ -4119,6 +5567,9 @@ 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>
@@ -4130,6 +5581,9 @@ incompatibility</span>).</li> +
+
+
<li>The text -wrap option can now be <span style="font-weight: bold;">none</span> to disable line
wrapping.</li>
@@ -4140,6 +5594,9 @@ wrapping.</li> +
+
+
</ul>
@@ -4149,6 +5606,9 @@ wrapping.</li> +
+
+
<h2>Event Changes</h2>
@@ -4158,6 +5618,9 @@ wrapping.</li> +
+
+
<ul>
@@ -4167,6 +5630,9 @@ wrapping.</li> +
+
+
<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.
@@ -4182,6 +5648,9 @@ file, and the new demo "Big List".</li> +
+
+
</ul>
@@ -4191,6 +5660,9 @@ file, and the new demo "Big List".</li> +
+
+
<h2>Other Changes</h2>
@@ -4200,6 +5672,9 @@ file, and the new demo "Big List".</li> +
+
+
<ul>
@@ -4209,6 +5684,9 @@ file, and the new demo "Big List".</li> +
+
+
<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>
@@ -4220,6 +5698,9 @@ is true.</li> +
+
+
</ul>
@@ -4229,6 +5710,9 @@ is true.</li> +
+
+
<h2>Demo Changes</h2>
@@ -4238,6 +5722,9 @@ is true.</li> +
+
+
<ul>
@@ -4247,6 +5734,9 @@ is true.</li> +
+
+
<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>
@@ -4258,6 +5748,9 @@ 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>
@@ -4270,6 +5763,9 @@ 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
@@ -4282,6 +5778,9 @@ versions of Windows but it hasn't been tested.</li> +
+
+
</ul>
@@ -4291,6 +5790,9 @@ versions of Windows but it hasn't been tested.</li> +
+
+
<hr style="width: 100%; height: 2px;">
<h1>What's New in TkTreeCtrl 2.0</h1>
@@ -4301,6 +5803,9 @@ versions of Windows but it hasn't been tested.</li> +
+
+
<h2>TreeCtrl Configuration Options</h2>
@@ -4310,6 +5815,9 @@ versions of Windows but it hasn't been tested.</li> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -4319,6 +5827,9 @@ versions of Windows but it hasn't been tested.</li> +
+
+
<tbody>
@@ -4328,6 +5839,9 @@ versions of Windows but it hasn't been tested.</li> +
+
+
<tr>
@@ -4337,6 +5851,9 @@ versions of Windows but it hasn't been tested.</li> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Replaced</th>
@@ -4346,6 +5863,9 @@ versions of Windows but it hasn't been tested.</li> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
@@ -4357,6 +5877,9 @@ instead</th> +
+
+
</tr>
@@ -4366,6 +5889,9 @@ instead</th> +
+
+
<tr>
@@ -4375,6 +5901,9 @@ instead</th> +
+
+
<td>-openbuttonimage</td>
@@ -4384,6 +5913,9 @@ instead</th> +
+
+
<td>-buttonimage</td>
@@ -4393,6 +5925,9 @@ instead</th> +
+
+
</tr>
@@ -4402,6 +5937,9 @@ instead</th> +
+
+
<tr>
@@ -4411,6 +5949,9 @@ instead</th> +
+
+
<td>-closedbuttonimage</td>
@@ -4420,6 +5961,9 @@ instead</th> +
+
+
<td>-buttonimage</td>
@@ -4429,6 +5973,9 @@ instead</th> +
+
+
</tr>
@@ -4438,6 +5985,9 @@ instead</th> +
+
+
<tr>
@@ -4447,6 +5997,9 @@ instead</th> +
+
+
<td>-openbuttonbitmap</td>
@@ -4456,6 +6009,9 @@ instead</th> +
+
+
<td>-buttonbitmap</td>
@@ -4465,6 +6021,9 @@ instead</th> +
+
+
</tr>
@@ -4474,6 +6033,9 @@ instead</th> +
+
+
<tr>
@@ -4483,6 +6045,9 @@ instead</th> +
+
+
<td>-closedbuttonbitmap</td>
@@ -4492,6 +6057,9 @@ instead</th> +
+
+
<td>-buttonbitmap</td>
@@ -4501,6 +6069,9 @@ instead</th> +
+
+
</tr>
@@ -4510,6 +6081,9 @@ instead</th> +
+
+
<tr>
@@ -4519,6 +6093,9 @@ instead</th> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Usage
Changed</th>
@@ -4529,6 +6106,9 @@ Changed</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">How
it changed</th>
@@ -4539,6 +6119,9 @@ it changed</th> +
+
+
</tr>
@@ -4548,6 +6131,9 @@ it changed</th> +
+
+
<tr>
@@ -4557,6 +6143,9 @@ it changed</th> +
+
+
<td>-backgroundmode</td>
@@ -4566,6 +6155,9 @@ it changed</th> +
+
+
<td>The values "index" and "visindex" are deprecated. The
value
"order" should be used instead of "index", and
@@ -4580,6 +6172,9 @@ index" command.</td> +
+
+
</tr>
@@ -4589,6 +6184,9 @@ index" command.</td> +
+
+
<tr>
@@ -4598,6 +6196,9 @@ index" command.</td> +
+
+
<td>-treecolumn</td>
@@ -4607,6 +6208,9 @@ index" command.</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
@@ -4620,6 +6224,9 @@ buttons/lines.</td> +
+
+
</tr>
@@ -4629,6 +6236,9 @@ buttons/lines.</td> +
+
+
<tr>
@@ -4638,6 +6248,9 @@ buttons/lines.</td> +
+
+
<th style="background-color: rgb(255, 255, 204);">New</th>
@@ -4647,6 +6260,9 @@ buttons/lines.</td> +
+
+
<td></td>
@@ -4656,6 +6272,9 @@ buttons/lines.</td> +
+
+
</tr>
@@ -4665,6 +6284,9 @@ buttons/lines.</td> +
+
+
<tr>
@@ -4674,6 +6296,9 @@ buttons/lines.</td> +
+
+
<td>-backgroundimage</td>
@@ -4683,6 +6308,9 @@ buttons/lines.</td> +
+
+
<td></td>
@@ -4692,6 +6320,9 @@ buttons/lines.</td> +
+
+
</tr>
@@ -4701,6 +6332,9 @@ buttons/lines.</td> +
+
+
<tr>
@@ -4710,6 +6344,9 @@ buttons/lines.</td> +
+
+
<td>-columnprefix</td>
@@ -4719,6 +6356,9 @@ buttons/lines.</td> +
+
+
<td></td>
@@ -4728,6 +6368,9 @@ buttons/lines.</td> +
+
+
</tr>
@@ -4737,6 +6380,9 @@ buttons/lines.</td> +
+
+
<tr>
@@ -4746,6 +6392,9 @@ buttons/lines.</td> +
+
+
<td>-columnresizemode</td>
@@ -4755,6 +6404,9 @@ buttons/lines.</td> +
+
+
<td></td>
@@ -4764,6 +6416,9 @@ buttons/lines.</td> +
+
+
</tr>
@@ -4773,6 +6428,9 @@ buttons/lines.</td> +
+
+
<tr>
@@ -4782,6 +6440,9 @@ buttons/lines.</td> +
+
+
<td>-itemprefix</td>
@@ -4791,6 +6452,9 @@ buttons/lines.</td> +
+
+
<td></td>
@@ -4800,6 +6464,9 @@ buttons/lines.</td> +
+
+
</tr>
@@ -4809,6 +6476,9 @@ buttons/lines.</td> +
+
+
<tr>
@@ -4818,6 +6488,9 @@ buttons/lines.</td> +
+
+
<td>-minitemheight</td>
@@ -4827,6 +6500,9 @@ buttons/lines.</td> +
+
+
<td></td>
@@ -4836,6 +6512,9 @@ buttons/lines.</td> +
+
+
</tr>
@@ -4845,6 +6524,9 @@ buttons/lines.</td> +
+
+
<tr>
@@ -4854,6 +6536,9 @@ buttons/lines.</td> +
+
+
<td>-usetheme</td>
@@ -4863,6 +6548,9 @@ buttons/lines.</td> +
+
+
<td></td>
@@ -4872,6 +6560,9 @@ buttons/lines.</td> +
+
+
</tr>
@@ -4881,6 +6572,12 @@ buttons/lines.</td> +
+
+
+
+
+
@@ -4898,6 +6595,9 @@ buttons/lines.</td> +
+
+
<h2>TreeCtrl Commands</h2>
@@ -4907,6 +6607,9 @@ buttons/lines.</td> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -4916,6 +6619,9 @@ buttons/lines.</td> +
+
+
<tbody>
@@ -4925,6 +6631,9 @@ buttons/lines.</td> +
+
+
<tr>
@@ -4934,6 +6643,9 @@ buttons/lines.</td> +
+
+
<th style="width: 50%; background-color: rgb(255, 255, 204);">Deprecated</th>
@@ -4943,6 +6655,9 @@ buttons/lines.</td> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
@@ -4954,6 +6669,9 @@ instead</th> +
+
+
</tr>
@@ -4963,6 +6681,9 @@ instead</th> +
+
+
<tr>
@@ -4972,6 +6693,9 @@ instead</th> +
+
+
<td>compare</td>
@@ -4981,6 +6705,9 @@ instead</th> +
+
+
<td>item compare</td>
@@ -4990,6 +6717,9 @@ instead</th> +
+
+
</tr>
@@ -4999,6 +6729,9 @@ instead</th> +
+
+
<tr>
@@ -5008,6 +6741,9 @@ instead</th> +
+
+
<td>index</td>
@@ -5017,6 +6753,9 @@ instead</th> +
+
+
<td>item id</td>
@@ -5026,6 +6765,9 @@ instead</th> +
+
+
</tr>
@@ -5035,6 +6777,9 @@ instead</th> +
+
+
<tr>
@@ -5044,6 +6789,9 @@ instead</th> +
+
+
<td>numcolumns</td>
@@ -5053,6 +6801,9 @@ instead</th> +
+
+
<td>column count</td>
@@ -5062,6 +6813,9 @@ instead</th> +
+
+
</tr>
@@ -5071,6 +6825,9 @@ instead</th> +
+
+
<tr>
@@ -5080,6 +6837,9 @@ instead</th> +
+
+
<td>numitems</td>
@@ -5089,6 +6849,9 @@ instead</th> +
+
+
<td>item count</td>
@@ -5098,6 +6861,9 @@ instead</th> +
+
+
</tr>
@@ -5107,6 +6873,9 @@ instead</th> +
+
+
<tr>
@@ -5116,6 +6885,9 @@ instead</th> +
+
+
<td>range</td>
@@ -5125,6 +6897,9 @@ instead</th> +
+
+
<td>item range</td>
@@ -5134,6 +6909,9 @@ instead</th> +
+
+
</tr>
@@ -5143,6 +6921,12 @@ instead</th> +
+
+
+
+
+
@@ -5160,6 +6944,9 @@ instead</th> +
+
+
<h2>Column Configuration Options</h2>
@@ -5169,6 +6956,9 @@ instead</th> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -5178,6 +6968,9 @@ instead</th> +
+
+
<tbody>
@@ -5187,6 +6980,9 @@ instead</th> +
+
+
<tr>
@@ -5196,6 +6992,9 @@ instead</th> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Removed</th>
@@ -5205,6 +7004,9 @@ instead</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
@@ -5216,6 +7018,9 @@ instead</th> +
+
+
</tr>
@@ -5225,6 +7030,9 @@ instead</th> +
+
+
<tr>
@@ -5234,6 +7042,9 @@ instead</th> +
+
+
<td>-relief<br>
@@ -5243,6 +7054,9 @@ instead</th> +
+
+
</td>
@@ -5252,6 +7066,9 @@ instead</th> +
+
+
<td>-state</td>
@@ -5261,6 +7078,9 @@ instead</th> +
+
+
</tr>
@@ -5270,6 +7090,9 @@ instead</th> +
+
+
<tr>
@@ -5279,6 +7102,9 @@ instead</th> +
+
+
<td>-sunken</td>
@@ -5288,6 +7114,9 @@ instead</th> +
+
+
<td>-state</td>
@@ -5297,6 +7126,9 @@ instead</th> +
+
+
</tr>
@@ -5306,6 +7138,9 @@ instead</th> +
+
+
<tr>
@@ -5315,6 +7150,9 @@ instead</th> +
+
+
<th style="background-color: rgb(255, 255, 204);">Renamed<br>
@@ -5324,6 +7162,9 @@ instead</th> +
+
+
</th>
@@ -5333,6 +7174,9 @@ instead</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">New
name</th>
@@ -5343,6 +7187,9 @@ name</th> +
+
+
</tr>
@@ -5352,6 +7199,9 @@ name</th> +
+
+
<tr>
@@ -5361,6 +7211,9 @@ name</th> +
+
+
<td>-arrowpad</td>
@@ -5370,6 +7223,9 @@ name</th> +
+
+
<td>-arrowpadx</td>
@@ -5379,6 +7235,9 @@ name</th> +
+
+
</tr>
@@ -5388,6 +7247,9 @@ name</th> +
+
+
<tr>
@@ -5397,6 +7259,9 @@ name</th> +
+
+
<th style="background-color: rgb(255, 255, 204);">Usage
Changed</th>
@@ -5407,6 +7272,9 @@ Changed</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">How
it changed</th>
@@ -5417,6 +7285,9 @@ it changed</th> +
+
+
</tr>
@@ -5426,6 +7297,9 @@ it changed</th> +
+
+
<tr>
@@ -5435,6 +7309,9 @@ it changed</th> +
+
+
<td>-background</td>
@@ -5444,6 +7321,9 @@ it changed</th> +
+
+
<td>This is now a per-state option. See COLUMNS in the help
file
for valid state names.</td>
@@ -5455,6 +7335,9 @@ for valid state names.</td> +
+
+
</tr>
@@ -5464,6 +7347,9 @@ for valid state names.</td> +
+
+
<tr>
@@ -5473,6 +7359,9 @@ for valid state names.</td> +
+
+
<th style="background-color: rgb(255, 255, 204);">New<br>
@@ -5482,6 +7371,9 @@ for valid state names.</td> +
+
+
</th>
@@ -5491,6 +7383,9 @@ for valid state names.</td> +
+
+
<td></td>
@@ -5500,6 +7395,9 @@ for valid state names.</td> +
+
+
</tr>
@@ -5509,6 +7407,9 @@ for valid state names.</td> +
+
+
<tr>
@@ -5518,6 +7419,9 @@ for valid state names.</td> +
+
+
<td>-arrowbitmap<br>
@@ -5527,6 +7431,9 @@ for valid state names.</td> +
+
+
</td>
@@ -5536,6 +7443,9 @@ for valid state names.</td> +
+
+
<td></td>
@@ -5545,6 +7455,9 @@ for valid state names.</td> +
+
+
</tr>
@@ -5554,6 +7467,9 @@ for valid state names.</td> +
+
+
<tr>
@@ -5563,6 +7479,9 @@ for valid state names.</td> +
+
+
<td>-arrowimage</td>
@@ -5572,6 +7491,9 @@ for valid state names.</td> +
+
+
<td></td>
@@ -5581,6 +7503,9 @@ for valid state names.</td> +
+
+
</tr>
@@ -5590,6 +7515,9 @@ for valid state names.</td> +
+
+
<tr>
@@ -5599,6 +7527,9 @@ for valid state names.</td> +
+
+
<td>-arrowpady</td>
@@ -5608,6 +7539,9 @@ for valid state names.</td> +
+
+
<td></td>
@@ -5617,6 +7551,9 @@ for valid state names.</td> +
+
+
</tr>
@@ -5626,6 +7563,9 @@ for valid state names.</td> +
+
+
<tr>
@@ -5635,6 +7575,9 @@ for valid state names.</td> +
+
+
<td>-maxwidth</td>
@@ -5644,6 +7587,9 @@ for valid state names.</td> +
+
+
<td></td>
@@ -5653,6 +7599,9 @@ for valid state names.</td> +
+
+
</tr>
@@ -5662,6 +7611,9 @@ for valid state names.</td> +
+
+
<tr>
@@ -5671,6 +7623,9 @@ for valid state names.</td> +
+
+
<td>-resize</td>
@@ -5680,6 +7635,9 @@ for valid state names.</td> +
+
+
<td></td>
@@ -5689,6 +7647,9 @@ for valid state names.</td> +
+
+
</tr>
@@ -5698,6 +7659,9 @@ for valid state names.</td> +
+
+
<tr>
@@ -5707,6 +7671,9 @@ for valid state names.</td> +
+
+
<td>-state</td>
@@ -5716,6 +7683,9 @@ for valid state names.</td> +
+
+
<td></td>
@@ -5725,6 +7695,9 @@ for valid state names.</td> +
+
+
</tr>
@@ -5734,6 +7707,9 @@ for valid state names.</td> +
+
+
<tr>
@@ -5743,6 +7719,9 @@ for valid state names.</td> +
+
+
<td>-textlines</td>
@@ -5752,6 +7731,9 @@ for valid state names.</td> +
+
+
<td></td>
@@ -5761,6 +7743,9 @@ for valid state names.</td> +
+
+
</tr>
@@ -5770,6 +7755,12 @@ for valid state names.</td> +
+
+
+
+
+
@@ -5787,6 +7778,9 @@ for valid state names.</td> +
+
+
<h2>Column Command</h2>
@@ -5796,6 +7790,9 @@ for valid state names.</td> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -5805,6 +7802,9 @@ for valid state names.</td> +
+
+
<tbody>
@@ -5814,6 +7814,9 @@ for valid state names.</td> +
+
+
<tr>
@@ -5823,6 +7826,9 @@ for valid state names.</td> +
+
+
<th style="background-color: rgb(255, 255, 204);">Deprecated</th>
@@ -5832,6 +7838,9 @@ for valid state names.</td> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
@@ -5843,6 +7852,9 @@ instead</th> +
+
+
</tr>
@@ -5852,6 +7864,9 @@ instead</th> +
+
+
<tr>
@@ -5861,6 +7876,9 @@ instead</th> +
+
+
<td>column index</td>
@@ -5870,6 +7888,9 @@ instead</th> +
+
+
<td>column id</td>
@@ -5879,6 +7900,9 @@ instead</th> +
+
+
</tr>
@@ -5888,6 +7912,9 @@ instead</th> +
+
+
<tr>
@@ -5897,6 +7924,9 @@ instead</th> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
@@ -5907,6 +7937,9 @@ Changed</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
@@ -5917,6 +7950,9 @@ changed</th> +
+
+
</tr>
@@ -5926,6 +7962,9 @@ changed</th> +
+
+
<tr>
@@ -5935,6 +7974,9 @@ changed</th> +
+
+
<td>column configure<br>
@@ -5944,6 +7986,9 @@ changed</th> +
+
+
</td>
@@ -5953,6 +7998,9 @@ changed</th> +
+
+
<td>A column description of "all" is allowed if at least
one
option-value pair is given.<br>
@@ -5964,6 +8012,9 @@ option-value pair is given.<br> +
+
+
</td>
@@ -5973,6 +8024,9 @@ option-value pair is given.<br> +
+
+
</tr>
@@ -5982,6 +8036,9 @@ option-value pair is given.<br> +
+
+
<tr>
@@ -5991,6 +8048,9 @@ option-value pair is given.<br> +
+
+
<td>column create</td>
@@ -6000,6 +8060,9 @@ option-value pair is given.<br> +
+
+
<td>The result is a unique identifier. Previously the
result was
an
@@ -6012,6 +8075,9 @@ index in the list of columns.</td> +
+
+
</tr>
@@ -6021,6 +8087,9 @@ index in the list of columns.</td> +
+
+
<tr>
@@ -6030,6 +8099,9 @@ index in the list of columns.</td> +
+
+
<td>column delete</td>
@@ -6039,6 +8111,9 @@ index in the list of columns.</td> +
+
+
<td>A column description of "all" is allowed.</td>
@@ -6048,6 +8123,9 @@ index in the list of columns.</td> +
+
+
</tr>
@@ -6057,6 +8135,9 @@ index in the list of columns.</td> +
+
+
<tr>
@@ -6066,6 +8147,9 @@ index in the list of columns.</td> +
+
+
<th style="background-color: rgb(255, 255, 204);">New</th>
@@ -6075,6 +8159,9 @@ index in the list of columns.</td> +
+
+
<th style="background-color: rgb(204, 255, 255);">Comment</th>
@@ -6084,6 +8171,9 @@ index in the list of columns.</td> +
+
+
</tr>
@@ -6093,6 +8183,9 @@ index in the list of columns.</td> +
+
+
<tr>
@@ -6102,6 +8195,9 @@ index in the list of columns.</td> +
+
+
<td>column compare</td>
@@ -6111,6 +8207,9 @@ index in the list of columns.</td> +
+
+
<td></td>
@@ -6120,6 +8219,9 @@ index in the list of columns.</td> +
+
+
</tr>
@@ -6129,6 +8231,9 @@ index in the list of columns.</td> +
+
+
<tr>
@@ -6138,6 +8243,9 @@ index in the list of columns.</td> +
+
+
<td>column count</td>
@@ -6147,6 +8255,9 @@ index in the list of columns.</td> +
+
+
<td>replaces "numcolumns"</td>
@@ -6156,6 +8267,9 @@ index in the list of columns.</td> +
+
+
</tr>
@@ -6165,6 +8279,9 @@ index in the list of columns.</td> +
+
+
<tr>
@@ -6174,6 +8291,9 @@ index in the list of columns.</td> +
+
+
<td>column dragconfigure</td>
@@ -6183,6 +8303,9 @@ index in the list of columns.</td> +
+
+
<td></td>
@@ -6192,6 +8315,9 @@ index in the list of columns.</td> +
+
+
</tr>
@@ -6201,6 +8327,9 @@ index in the list of columns.</td> +
+
+
<tr>
@@ -6210,6 +8339,9 @@ index in the list of columns.</td> +
+
+
<td>column dragcget</td>
@@ -6219,6 +8351,9 @@ index in the list of columns.</td> +
+
+
<td></td>
@@ -6228,6 +8363,9 @@ index in the list of columns.</td> +
+
+
</tr>
@@ -6237,6 +8375,9 @@ index in the list of columns.</td> +
+
+
<tr>
@@ -6246,6 +8387,9 @@ index in the list of columns.</td> +
+
+
<td>column id</td>
@@ -6255,6 +8399,9 @@ index in the list of columns.</td> +
+
+
<td>replaces "column index"</td>
@@ -6264,6 +8411,9 @@ index in the list of columns.</td> +
+
+
</tr>
@@ -6273,6 +8423,9 @@ index in the list of columns.</td> +
+
+
<tr>
@@ -6282,6 +8435,9 @@ index in the list of columns.</td> +
+
+
<td>column list</td>
@@ -6291,6 +8447,9 @@ index in the list of columns.</td> +
+
+
<td></td>
@@ -6300,6 +8459,9 @@ index in the list of columns.</td> +
+
+
</tr>
@@ -6309,6 +8471,9 @@ index in the list of columns.</td> +
+
+
<tr>
@@ -6318,6 +8483,9 @@ index in the list of columns.</td> +
+
+
<td>column order</td>
@@ -6327,6 +8495,9 @@ index in the list of columns.</td> +
+
+
<td></td>
@@ -6336,6 +8507,9 @@ index in the list of columns.</td> +
+
+
</tr>
@@ -6345,6 +8519,12 @@ index in the list of columns.</td> +
+
+
+
+
+
@@ -6362,6 +8542,9 @@ index in the list of columns.</td> +
+
+
<h2>Item Command</h2>
@@ -6371,6 +8554,9 @@ index in the list of columns.</td> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -6380,6 +8566,9 @@ index in the list of columns.</td> +
+
+
<tbody>
@@ -6389,6 +8578,9 @@ index in the list of columns.</td> +
+
+
<tr>
@@ -6398,6 +8590,9 @@ index in the list of columns.</td> +
+
+
<th style="background-color: rgb(255, 255, 204);">Removed</th>
@@ -6407,6 +8602,9 @@ index in the list of columns.</td> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
to use
instead</th>
@@ -6418,6 +8616,9 @@ instead</th> +
+
+
</tr>
@@ -6427,6 +8628,9 @@ instead</th> +
+
+
<tr>
@@ -6436,6 +8640,9 @@ instead</th> +
+
+
<td>item index</td>
@@ -6445,6 +8652,9 @@ instead</th> +
+
+
<td>item order</td>
@@ -6454,6 +8664,9 @@ instead</th> +
+
+
</tr>
@@ -6463,6 +8676,9 @@ instead</th> +
+
+
<tr>
@@ -6472,6 +8688,9 @@ instead</th> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">New</th>
@@ -6481,6 +8700,9 @@ instead</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">Comment</th>
@@ -6490,6 +8712,9 @@ instead</th> +
+
+
</tr>
@@ -6499,6 +8724,9 @@ instead</th> +
+
+
<tr>
@@ -6508,6 +8736,9 @@ instead</th> +
+
+
<td>item compare</td>
@@ -6517,6 +8748,9 @@ instead</th> +
+
+
<td>replaces "compare"</td>
@@ -6526,6 +8760,9 @@ instead</th> +
+
+
</tr>
@@ -6535,6 +8772,9 @@ instead</th> +
+
+
<tr>
@@ -6544,6 +8784,9 @@ instead</th> +
+
+
<td>item count</td>
@@ -6553,6 +8796,9 @@ instead</th> +
+
+
<td>replaces "numitems"</td>
@@ -6562,6 +8808,9 @@ instead</th> +
+
+
</tr>
@@ -6571,6 +8820,9 @@ instead</th> +
+
+
<tr>
@@ -6580,6 +8832,9 @@ instead</th> +
+
+
<td>item id</td>
@@ -6589,6 +8844,9 @@ instead</th> +
+
+
<td>replaces "index"</td>
@@ -6598,6 +8856,9 @@ instead</th> +
+
+
</tr>
@@ -6607,6 +8868,9 @@ instead</th> +
+
+
<tr>
@@ -6616,6 +8880,9 @@ instead</th> +
+
+
<td>item order</td>
@@ -6625,6 +8892,9 @@ instead</th> +
+
+
<td>replaces "item index"</td>
@@ -6634,6 +8904,9 @@ instead</th> +
+
+
</tr>
@@ -6643,6 +8916,9 @@ instead</th> +
+
+
<tr>
@@ -6652,6 +8928,9 @@ instead</th> +
+
+
<td>item range</td>
@@ -6661,6 +8940,9 @@ instead</th> +
+
+
<td>replaces "range"</td>
@@ -6670,6 +8952,9 @@ instead</th> +
+
+
</tr>
@@ -6679,6 +8964,12 @@ instead</th> +
+
+
+
+
+
@@ -6696,6 +8987,9 @@ instead</th> +
+
+
<h2>Notify Command</h2>
@@ -6705,6 +8999,9 @@ instead</th> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -6714,6 +9011,9 @@ instead</th> +
+
+
<tbody>
@@ -6723,6 +9023,9 @@ instead</th> +
+
+
<tr>
@@ -6732,6 +9035,9 @@ instead</th> +
+
+
<th style="background-color: rgb(255, 255, 204); width: 50%;">Arguments/Result
Changed</th>
@@ -6742,6 +9048,9 @@ Changed</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">What
changed</th>
@@ -6752,6 +9061,9 @@ changed</th> +
+
+
</tr>
@@ -6761,6 +9073,9 @@ changed</th> +
+
+
<tr>
@@ -6770,6 +9085,9 @@ changed</th> +
+
+
<td>notify generate<br>
@@ -6779,6 +9097,9 @@ changed</th> +
+
+
</td>
@@ -6788,6 +9109,9 @@ changed</th> +
+
+
<td>Added optional <span style="font-style: italic;">percentsCommand</span>
argument</td>
@@ -6798,6 +9122,9 @@ argument</td> +
+
+
</tr>
@@ -6807,6 +9134,9 @@ argument</td> +
+
+
<tr>
@@ -6816,6 +9146,9 @@ argument</td> +
+
+
<td>notify install</td>
@@ -6825,6 +9158,9 @@ argument</td> +
+
+
<td>Old syntax (supported but deprecated):<br>
@@ -6834,6 +9170,12 @@ argument</td> +
+
+
+
+
+
@@ -6850,6 +9192,12 @@ argument</td> +
+
+
+
+
+
@@ -6866,6 +9214,9 @@ argument</td> +
+
+
New syntax:<br>
@@ -6875,6 +9226,12 @@ New syntax:<br> +
+
+
+
+
+
@@ -6891,6 +9248,12 @@ New syntax:<br> +
+
+
+
+
+
@@ -6907,6 +9270,9 @@ New syntax:<br> +
+
+
</td>
@@ -6916,6 +9282,9 @@ New syntax:<br> +
+
+
</tr>
@@ -6925,6 +9294,9 @@ New syntax:<br> +
+
+
<tr>
@@ -6934,6 +9306,9 @@ New syntax:<br> +
+
+
<td>notify linkage</td>
@@ -6943,6 +9318,9 @@ New syntax:<br> +
+
+
<td>Old syntax (supported but deprecated):<br>
@@ -6952,6 +9330,12 @@ New syntax:<br> +
+
+
+
+
+
@@ -6967,6 +9351,9 @@ New syntax:<br> +
+
+
<pre><span style="font-weight: bold;">notify linkage</span> <span style="font-style: italic;">eventName</span></pre>
@@ -6976,6 +9363,12 @@ New syntax:<br> +
+
+
+
+
+
@@ -6992,6 +9385,9 @@ New syntax:<br> +
+
+
</div>
@@ -7001,6 +9397,9 @@ New syntax:<br> +
+
+
New syntax:<br>
@@ -7010,6 +9409,12 @@ New syntax:<br> +
+
+
+
+
+
@@ -7025,6 +9430,9 @@ New syntax:<br> +
+
+
<pre><span style="font-weight: bold;">notify linkage</span> <<span style="font-style: italic;">eventName</span>></pre>
@@ -7034,6 +9442,12 @@ New syntax:<br> +
+
+
+
+
+
@@ -7050,6 +9464,9 @@ New syntax:<br> +
+
+
</div>
@@ -7059,6 +9476,9 @@ New syntax:<br> +
+
+
</td>
@@ -7068,6 +9488,9 @@ New syntax:<br> +
+
+
</tr>
@@ -7077,6 +9500,9 @@ New syntax:<br> +
+
+
<tr>
@@ -7086,6 +9512,9 @@ New syntax:<br> +
+
+
<td>notify uninstall</td>
@@ -7095,6 +9524,9 @@ New syntax:<br> +
+
+
<td>see <span style="font-weight: bold;">notify
install</span>
above</td>
@@ -7106,6 +9538,9 @@ above</td> +
+
+
</tr>
@@ -7115,6 +9550,12 @@ above</td> +
+
+
+
+
+
@@ -7132,6 +9573,9 @@ above</td> +
+
+
<h2>Style Layout Options</h2>
@@ -7141,6 +9585,9 @@ above</td> +
+
+
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
@@ -7150,6 +9597,9 @@ above</td> +
+
+
<tbody>
@@ -7159,6 +9609,9 @@ above</td> +
+
+
<tr>
@@ -7168,6 +9621,9 @@ above</td> +
+
+
<th style="background-color: rgb(255, 255, 204);">Usage
Changed</th>
@@ -7178,6 +9634,9 @@ Changed</th> +
+
+
<th style="background-color: rgb(204, 255, 255);">How
it changed</th>
@@ -7188,6 +9647,9 @@ it changed</th> +
+
+
</tr>
@@ -7197,6 +9659,9 @@ it changed</th> +
+
+
<tr>
@@ -7206,6 +9671,9 @@ it changed</th> +
+
+
<td>-iexpand</td>
@@ -7215,6 +9683,9 @@ it changed</th> +
+
+
<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
@@ -7228,6 +9699,12 @@ update your code, you will probably want to change this:<br> +
+
+
+
+
+
@@ -7243,6 +9720,9 @@ update your code, you will probably want to change this:<br> +
+
+
<pre>$T style layout $S $E -iexpand we</pre>
@@ -7252,6 +9732,9 @@ update your code, you will probably want to change this:<br> +
+
+
</div>
@@ -7261,6 +9744,9 @@ update your code, you will probably want to change this:<br> +
+
+
to this:<br>
@@ -7270,6 +9756,12 @@ to this:<br> +
+
+
+
+
+
@@ -7285,6 +9777,9 @@ to this:<br> +
+
+
<pre>$T style layout $S $E -iexpand x<br></pre>
@@ -7294,6 +9789,9 @@ to this:<br> +
+
+
</div>
@@ -7303,6 +9801,9 @@ to this:<br> +
+
+
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>
@@ -7314,6 +9815,9 @@ surrounds.</td> +
+
+
</tr>
@@ -7323,6 +9827,9 @@ surrounds.</td> +
+
+
<tr>
@@ -7332,6 +9839,9 @@ surrounds.</td> +
+
+
<th style="width: 50%; background-color: rgb(255, 255, 204);">New<br>
@@ -7341,6 +9851,9 @@ surrounds.</td> +
+
+
</th>
@@ -7350,6 +9863,9 @@ surrounds.</td> +
+
+
<td></td>
@@ -7359,6 +9875,9 @@ surrounds.</td> +
+
+
</tr>
@@ -7368,6 +9887,9 @@ surrounds.</td> +
+
+
<tr>
@@ -7377,6 +9899,9 @@ surrounds.</td> +
+
+
<td>-height</td>
@@ -7386,6 +9911,9 @@ surrounds.</td> +
+
+
<td></td>
@@ -7395,6 +9923,9 @@ surrounds.</td> +
+
+
</tr>
@@ -7404,6 +9935,9 @@ surrounds.</td> +
+
+
<tr>
@@ -7413,6 +9947,9 @@ surrounds.</td> +
+
+
<td>-maxheight</td>
@@ -7422,6 +9959,9 @@ surrounds.</td> +
+
+
<td></td>
@@ -7431,6 +9971,9 @@ surrounds.</td> +
+
+
</tr>
@@ -7440,6 +9983,9 @@ surrounds.</td> +
+
+
<tr>
@@ -7449,6 +9995,9 @@ surrounds.</td> +
+
+
<td>-maxwidth</td>
@@ -7458,6 +10007,9 @@ surrounds.</td> +
+
+
<td></td>
@@ -7467,6 +10019,9 @@ surrounds.</td> +
+
+
</tr>
@@ -7476,6 +10031,9 @@ surrounds.</td> +
+
+
<tr>
@@ -7485,6 +10043,9 @@ surrounds.</td> +
+
+
<td>-minheight</td>
@@ -7494,6 +10055,9 @@ surrounds.</td> +
+
+
<td></td>
@@ -7503,6 +10067,9 @@ surrounds.</td> +
+
+
</tr>
@@ -7512,6 +10079,9 @@ surrounds.</td> +
+
+
<tr>
@@ -7521,6 +10091,9 @@ surrounds.</td> +
+
+
<td>-minwidth</td>
@@ -7530,6 +10103,9 @@ surrounds.</td> +
+
+
<td></td>
@@ -7539,6 +10115,9 @@ surrounds.</td> +
+
+
</tr>
@@ -7548,6 +10127,9 @@ surrounds.</td> +
+
+
<tr>
@@ -7557,6 +10139,9 @@ surrounds.</td> +
+
+
<td>-sticky</td>
@@ -7566,6 +10151,9 @@ surrounds.</td> +
+
+
<td></td>
@@ -7575,6 +10163,9 @@ surrounds.</td> +
+
+
</tr>
@@ -7584,6 +10175,9 @@ surrounds.</td> +
+
+
<tr>
@@ -7593,6 +10187,9 @@ surrounds.</td> +
+
+
<td>-width</td>
@@ -7602,6 +10199,9 @@ surrounds.</td> +
+
+
<td></td>
@@ -7611,6 +10211,9 @@ surrounds.</td> +
+
+
</tr>
@@ -7620,6 +10223,12 @@ surrounds.</td> +
+
+
+
+
+
@@ -7637,6 +10246,9 @@ surrounds.</td> +
+
+
<h2>Element Changes</h2>
@@ -7646,6 +10258,9 @@ surrounds.</td> +
+
+
<ul>
@@ -7655,6 +10270,9 @@ surrounds.</td> +
+
+
<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
@@ -7667,6 +10285,9 @@ file.</li> +
+
+
<li>All element types have a new
per-state boolean option called <span style="font-weight: bold;">-draw</span>.</li>
@@ -7677,6 +10298,9 @@ per-state boolean option called <span style="font-weight: bold;">-draw</span>.</ +
+
+
<li>The <span style="font-weight: bold;">text</span>
element type
has a new option called <span style="font-weight: bold;">-textvariable</span>.
@@ -7690,6 +10314,9 @@ See the new demo +
+
+
</ul>
@@ -7699,6 +10326,9 @@ See the new demo +
+
+
<h2>Event Changes</h2>
@@ -7708,6 +10338,9 @@ See the new demo +
+
+
<ul>
@@ -7717,6 +10350,9 @@ See the new demo +
+
+
<li>2 new %-substitution characters <span style="font-weight: bold;">%P</span>
and <span style="font-weight: bold;">%?</span> are
allowed in binding
@@ -7730,6 +10366,9 @@ 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>
@@ -7741,6 +10380,9 @@ SUBSTITUTIONS section in the help file.</li> +
+
+
</ul>
@@ -7750,6 +10392,9 @@ SUBSTITUTIONS section in the help file.</li> +
+
+
<h2>Library Script Changes</h2>
@@ -7759,6 +10404,9 @@ SUBSTITUTIONS section in the help file.</li> +
+
+
<h3 style="margin-left: 40px;">filelist-bindings.tcl:</h3>
@@ -7768,6 +10416,9 @@ SUBSTITUTIONS section in the help file.</li> +
+
+
<ul>
@@ -7777,6 +10428,9 @@ SUBSTITUTIONS section in the help file.</li> +
+
+
<li>The Priv(edit) variable, which is used to specify which
text
elements may be edited, now has the same format as Priv(sensitive).
@@ -7789,6 +10443,9 @@ 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
@@ -7801,6 +10458,9 @@ 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
@@ -7813,6 +10473,9 @@ generated when editing a file name.</li> +
+
+
</ul>
@@ -7822,6 +10485,9 @@ generated when editing a file name.</li> +
+
+
<h3 style="margin-left: 40px;">treectrl.tcl:</h3>
@@ -7831,6 +10497,9 @@ generated when editing a file name.</li> +
+
+
<ul>
@@ -7840,6 +10509,9 @@ generated when editing a file name.</li> +
+
+
<li>On OSX/Aqua, the Command key is used to perform
discontinuous
selection. Previously the Control key was used but Command is specified
@@ -7852,6 +10524,9 @@ by Apple's user-interface guidelines.</li> +
+
+
</ul>
@@ -7861,6 +10536,9 @@ by Apple's user-interface guidelines.</li> +
+
+
<h2>Other Changes</h2>
@@ -7870,6 +10548,9 @@ by Apple's user-interface guidelines.</li> +
+
+
<ul>
@@ -7879,6 +10560,9 @@ by Apple's user-interface guidelines.</li> +
+
+
<li>On WinXP, the column headers and open/close buttons are
drawn
using the system theme if <span style="font-weight: bold;">-usetheme</span>
@@ -7891,6 +10575,9 @@ 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
@@ -7907,6 +10594,9 @@ 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>
@@ -7918,6 +10608,9 @@ file.</li> +
+
+
<li>Columns can be specified in new ways. See the COLUMN
DESCRIPTION
section in the help file.</li>
@@ -7929,6 +10622,9 @@ section in the help file.</li> +
+
+
<li>Added new section DYNAMIC EVENTS to the help file.</li>
@@ -7938,6 +10634,9 @@ section in the help file.</li> +
+
+
<li>Added new section PER-STATE OPTIONS to the help file.</li>
@@ -7947,6 +10646,9 @@ section in 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
@@ -7959,6 +10661,9 @@ 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>
@@ -7969,6 +10674,9 @@ 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
@@ -7984,6 +10692,9 @@ scripts are found.</span></span></li> +
+
+
</ul>
@@ -7993,6 +10704,9 @@ scripts are found.</span></span></li> +
+
+
<h2>Demo Changes</h2>
@@ -8002,6 +10716,9 @@ scripts are found.</span></span></li> +
+
+
<ul>
@@ -8011,6 +10728,9 @@ scripts are found.</span></span></li> +
+
+
<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>
@@ -8022,6 +10742,9 @@ 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>
@@ -8033,6 +10756,9 @@ element.</li> +
+
+
<li>Added a new Event Browser window to display events
generated by
the main treectrl widget.</li>
@@ -8044,6 +10770,9 @@ 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>
@@ -8055,6 +10784,9 @@ OSX/Aqua.</li> +
+
+
<li>In the "Explorer" demos, the file name is hidden while
editing
the file name.</li>
@@ -8066,6 +10798,9 @@ the file name.</li> +
+
+
</ul>
@@ -8075,5 +10810,8 @@ the file name.</li> +
+
+
</body>
</html>
diff --git a/doc/treectrl.html b/doc/treectrl.html index 88b53c4..d7281e8 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.40 2006/11/03 22:31:04 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.41 2006/11/18 04:40:10 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.40 2006/11/03 22:31:04 treectrl Exp $ treectrl.n +<! -- CVS: $Id: treectrl.html,v 1.41 2006/11/18 04:40:10 treectrl Exp $ treectrl.n --> <body> -<h1> treectrl(n) 2.1.1 treectrl "Tk Commands"</h1> +<h1> treectrl(n) 2.2 treectrl "Tk Commands"</h1> <h2><a name="name">NAME</a></h2> <p> <p> treectrl - Create and manipulate hierarchical multicolumn widgets @@ -44,7 +44,7 @@ <a href="#keywords">KEYWORDS</a><br> <h2><a name="synopsis">SYNOPSIS</a></h2> <p> -package require <b>treectrl 2.1.1</b><br> +package require <b>treectrl 2.2</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> @@ -56,7 +56,7 @@ package require <b>treectrl 2.1.1</b><br> <tr valign=top ><td ><a href="#9"><i class='arg'>pathName</i> <b class='cmd'>column cget</b> <i class='arg'>columnDesc</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'>columnDesc</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 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="#12"><i class='arg'>pathName</i> <b class='cmd'>column count</b> ?<i class='arg'>columnDesc</i>?</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'>first</i> ?<i class='arg'>last</i>?</a></td></tr> <tr valign=top ><td ><a href="#15"><i class='arg'>pathName</i> <b class='cmd'>column dragcget</b> <i class='arg'>option</i></a></td></tr> @@ -110,7 +110,7 @@ package require <b>treectrl 2.1.1</b><br> <tr valign=top ><td ><a href="#63"><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="#64"><i class='arg'>pathName</i> <b class='cmd'>item complex</b> <i class='arg'>itemDesc</i> ?<i class='arg'>list...</i>?</a></td></tr> <tr valign=top ><td ><a href="#65"><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="#66"><i class='arg'>pathName</i> <b class='cmd'>item count</b> ?<i class='arg'>-visible</i>?</a></td></tr> +<tr valign=top ><td ><a href="#66"><i class='arg'>pathName</i> <b class='cmd'>item count</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 create</b> ?<i class='arg'>option value ...</i>?</a></td></tr> <tr valign=top ><td ><a href="#68"><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="#69"><i class='arg'>pathName</i> <b class='cmd'>item descendants</b> <i class='arg'>itemDesc</i></a></td></tr> @@ -849,12 +849,12 @@ for the column specified by the <dt><a name="10"><i class='arg'>pathName</i> <b class='cmd'>column configure</b> <i class='arg'>columnDesc</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 column specified by the +that it modifies options associated with the columns specified by the <a href="#column_description">column description</a> <i class='arg'>columnDesc</i> instead of modifying options for the overall treectrl widget. <i class='arg'>ColumnDesc</i> may be the string <strong>tail</strong> to specify the tail column. -If <i class='arg'>columnDesc</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 <i class='arg'>columnDesc</i> refers to more than one column, then at least one option-value pair +must be given. If no <i class='arg'>option</i> is specified, the command returns a list describing all of the available options for <i class='arg'>columnDesc</i> (see <strong>Tk_ConfigureInfo</strong> for information on the format of this list). @@ -882,12 +882,14 @@ 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> +<dt><a name="12"><i class='arg'>pathName</i> <b class='cmd'>column count</b> ?<i class='arg'>columnDesc</i>?</a><dd> -Returns a decimal string giving the number of +If no additional arguments are given, the result is 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 +deleted by the <b class='cmd'>column delete</b> widget command; in this case the <strong>tail</strong> column is not counted. +If <i class='arg'>columnDesc</i> is given, then the result is the number of columns that +match that <a href="#column_description">column description</a>. <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> @@ -1108,7 +1110,8 @@ The following forms of the command are supported: <dl> <dt><a name="33"><i class='arg'>pathName</i> <b class='cmd'>debug alloc</b></a><dd> -Returns a string giving partial statistics on memory allocations. +Returns a string giving partial statistics on memory allocations, if the package +was built with TREECTRL_DEBUG defined. <br><br> <dt><a name="34"><i class='arg'>pathName</i> <b class='cmd'>debug cget</b> <i class='arg'>option</i></a><dd> @@ -1202,12 +1205,12 @@ Returns a string useful for debugging vertical scrolling. <dt><a name="39"><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 -the item describing by <i class='arg'>itemDesc</i>, whereas depth is defined as -the number of steps you must go upward to reach to root item. -If no <i class='arg'>itemDesc</i> is specified, the maximum depth of all +If the additional argument <i class='arg'>itemDesc</i> is given, +then the result is a decimal string giving the depth of +the item described by <i class='arg'>itemDesc</i>. +If no <i class='arg'>itemDesc</i> is specified, then the maximum depth of all items in the treectrl widget is returned instead. +Depth is defined as the number of ancestors an item has. <br><br> <dt><a name="40"><i class='arg'>pathName</i> <b class='cmd'>dragimage</b> <i class='arg'>option</i> ?<i class='arg'>arg ...</i>?</a><dd> @@ -1448,20 +1451,12 @@ the first child to the last child. <br><br> <dt><a name="62"><i class='arg'>pathName</i> <b class='cmd'>item collapse</b> <i class='arg'>itemDesc</i> ?<strong>-recurse</strong>?</a><dd> -Switches off the <strong>open</strong> state of the item(s) -described by <i class='arg'>itemDesc</i>. -If the item has descendants, they are no longer displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options <strong>-buttonimage</strong> or <strong>-buttonbitmap</strong>, -or a <em>+</em> sign if no image or bitmap is configured. -If the item is already closed, this command has no effect. -<i class='arg'>ItemDesc</i> may also be the string <strong>all</strong>, -in which case all items of the treectrl widget are collapsed. -If <strong>-recurse</strong> is specified, all descendants of <i class='arg'>itemDesc</i> -will also be collapsed. -For every item, that actually will be collapsed, -two events are generated: +Switches off the <strong>open</strong> state of the item(s) described by <i class='arg'>itemDesc</i>. +If an item has descendants, then they are no longer displayed. +If an item is already closed, then this command has no effect on that item. +If <strong>-recurse</strong> is specified, then all descendants of the items described +by <i class='arg'>itemDesc</i> will also be collapsed. +For every item that actually will be collapsed, two events are generated: a <strong><Collapse-before></strong> event before the item state is changed, and a <strong><Collapse-after></strong> event after the item state was changed. @@ -1483,7 +1478,7 @@ This horrible command is now deprecated. Use <b class='cmd'>item element configu instead. For every column of the treectrl there may be specified one <i class='arg'>list</i>. Each <i class='arg'>list</i> should look like this: <p><table><tr><td bgcolor=black> </td><td><pre class='sample'> -{ {element option value...} {element option value...} ...} +{ {element option value ...} {element option value ...} ...} </pre></td></tr></table></p> Every <i class='arg'>option</i> must be known by the element's type (see <a href="#elements">ELEMENTS</a> below). @@ -1518,15 +1513,14 @@ the meaning of each option): </dl> -<dt><a name="66"><i class='arg'>pathName</i> <b class='cmd'>item count</b> ?<i class='arg'>-visible</i>?</a><dd> +<dt><a name="66"><i class='arg'>pathName</i> <b class='cmd'>item count</b> ?<i class='arg'>itemDesc</i>?</a><dd> -Returns a decimal string giving the number of +If no additional arguments are given, the result is 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. 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. -Additionally, for the root item, the treectrl option <strong>-showroot</strong> must -be true for the root item to be counted. +root item. +If the optional argument <i class='arg'>itemDesc</i> is given, then the result is the +number of items that match that <a href="#item_description">item description</a>. <br><br> <dt><a name="67"><i class='arg'>pathName</i> <b class='cmd'>item create</b> ?<i class='arg'>option value ...</i>?</a><dd> @@ -1548,7 +1542,8 @@ indicates whether or not an expand/collapse button should be drawn next to this item, typically to indicate the item has children. The button will only be displayed if: a) the column specified by the treectrl option <strong>-treecolumn</strong> is visible; -and b) the treectrl option <strong>-showbuttons</strong> is true +and b) the treectrl option <strong>-showbuttons</strong> is true; +and c) for the root item, the treectrl option <strong>-showrootbutton</strong> is true. <br><br> <dt><strong><strong>-count</strong></strong> <i class='arg'>numItems</i><dd> @@ -1619,7 +1614,7 @@ in all cases the specification of the root item is ignored. For each call to this command, two events may be generated. If any of the deleted items are selected, then a <strong><Selection></strong> event is generated just before the items are deleted. -If any items were actually deleted, then an <strong><ItemDelete></strong> event event is generated just before the items +If any items are going to be deleted, then an <strong><ItemDelete></strong> event event is generated just before the items are deleted. <br><br> @@ -1709,23 +1704,18 @@ Returns 1 if the item described by <i class='arg'>itemDesc</i> has the state <strong>enabled</strong> switched on, 0 otherwise. If <i class='arg'>boolean</i> is specified, then the <strong>enabled</strong> state of every item described by the <a href="#item_description">item description</a> <i class='arg'>itemDesc</i> is set accordingly. +All items are enabled when first created. Disabled items cannot be selected, +and are ignored by the default key-navigation and mouse bindings. <br><br> <dt><a name="77"><i class='arg'>pathName</i> <b class='cmd'>item expand</b> <i class='arg'>itemDesc</i> ?<strong>-recurse</strong>?</a><dd> Switches on the <strong>open</strong> state of the item(s) described by <i class='arg'>itemDesc</i>. -If the item has descendants, they are now displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options <strong>-buttonimage</strong> or <strong>-buttonbitmap</strong>, -or a <em>-</em> sign if no image or bitmap is configured. -If the item is already open, this command has no effect. -<i class='arg'>ItemDesc</i> may also be the string <strong>all</strong>, -in which case all items of the treectrl widget are expanded. -If <strong>-recurse</strong> is specified, all descendants of <i class='arg'>itemDesc</i> -will also be expanded. -For every item, that actually will be expanded, -two events are generated: +If an item has descendants, then they are now displayed. +If an item is already open, then this command has no effect on that item. +If <strong>-recurse</strong> is specified, then all descendants of the items described by +<i class='arg'>itemDesc</i> will also be expanded. +For every item that actually will be expanded, two events are generated: an <strong><Expand-before></strong> event before the item state is changed, and an <strong><Expand-after></strong> event after the item state was changed. @@ -2098,13 +2088,11 @@ want to set or retrieve the value of the -text option for a specific text elemen <dt><a name="108"><i class='arg'>pathName</i> <b class='cmd'>item toggle</b> <i class='arg'>itemDesc</i> ?<strong>-recurse</strong>?</a><dd> Changes the <strong>open</strong> state of the item(s) described by <i class='arg'>itemDesc</i>. -If the state is currently switched off, -this command does the same as the <b class='cmd'>item expand</b> widget command, +If the <strong>open</strong> state is currently switched off, then +this command does the same as the <b class='cmd'>item expand</b> widget command; otherwise the same as the <b class='cmd'>item collapse</b> widget command. -<i class='arg'>ItemDesc</i> may also be the string <strong>all</strong>, -in which case the state of all items of the treectrl widget are toggled. -If <strong>-recurse</strong> is specified, the state of all descendants of -<i class='arg'>itemDesc</i> will also be toggled. +If <strong>-recurse</strong> is specified, then the <strong>open</strong> state of all descendants of +the items described by <i class='arg'>itemDesc</i> will also be toggled. </dl> @@ -2188,15 +2176,19 @@ sets the corner to the given coordinates <i class='arg'>x</i> and <i class='arg' <br><br> <dt><a name="115"><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 -for every item which is displayed inside the marquee. -The first element of these lists is the numerical item id, -followed by another list with information about every column of the -item inside the marque. -These lists start with the column number, -followed by the elements of the style defined for the item in this column -if there are any. +Returns a list with information about any items intersecting the marquee. +The format of the returned list is: +<p><table><tr><td bgcolor=black> </td><td><pre class='sample'> +{ + {item {column element element ...} {column element element ...} ...} + {item {column element element ...} {column element element ...} ...} + ... +} +</pre></td></tr></table></p> +There may be zero sublists following an item id if the marquee is in the +button/line area of an item. There may be zero element names following a +column id if the item-column has no style or if the marquee does not +intersect any elements in that column. </dl> @@ -2966,8 +2958,10 @@ The value may have any of the forms acceptable to <strong>Tk_GetPixels</strong>. <br><br> <dt><strong><strong>-button</strong></strong> <i class='arg'>boolean</i><dd> -Indicates whether or not a mouse click on the column header should -change the sorting order of the tree. +Indicates whether or not the column header should be treated like a pushbutton. +When this option is true, the default bindings track <Button-1> events +in the header and generate a <Header-invoke> event when a <ButtonRelease-1> +event occurs in the header. See <a href="#dynamic_events">DYNAMIC EVENTS</a>. <br><br> <dt><strong><strong>-expand</strong></strong> <i class='arg'>boolean</i><dd> @@ -3038,7 +3032,7 @@ This option has no effect if the <strong>-width</strong> option is set. <br><br> <dt><strong><strong>-resize</strong></strong> <i class='arg'>boolean</i><dd> Specifies a boolean value that indicates whether the user should be allowed to -resize the column by dragging the right edge of the column's header. Default is true. +resize the column by dragging the edge of the column's header. Default is true. <br><br> <dt><strong><strong>-squeeze</strong></strong> <i class='arg'>boolean</i><dd> @@ -3164,7 +3158,7 @@ This keyword cannot be followed by any modifiers unless a single column is matched. You may run into trouble if <i class='arg'>tagExpr</i> looks like a column id or other keyword; also, <i class='arg'>tagExpr</i> must look like a single list element since column descriptions are properly-formed lists. To be safe you may want to -use the <strong>tag</strong> keyword followed by <i class='arg'>tagExpr</i>. +use the <strong>tag</strong> qualifier followed by <i class='arg'>tagExpr</i>. <br><br> <dt><strong>all</strong> <i class='arg'>QUALIFIERS</i><dd> @@ -3711,7 +3705,7 @@ This keyword cannot be followed by any modifiers unless a single item is matched. You may run into trouble if <i class='arg'>tagExpr</i> looks like an item id or other keyword; also, <i class='arg'>tagExpr</i> must look like a single list element since item descriptions are properly-formed lists. To be safe you may want to -use the <strong>tag</strong> keyword followed by <i class='arg'>tagExpr</i>. +use the <strong>tag</strong> qualifier followed by <i class='arg'>tagExpr</i>. <br><br> <dt><strong>active</strong><dd> diff --git a/doc/treectrl.man b/doc/treectrl.man index 77fcbc7..ad4329f 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.41 2006/11/03 22:31:05 treectrl Exp $} -][manpage_begin treectrl n 2.1.1] + $Id: treectrl.man,v 1.42 2006/11/18 04:40:10 treectrl Exp $} +][manpage_begin treectrl n 2.2] [moddesc {Tk Commands}] [titledesc {Create and manipulate hierarchical multicolumn widgets}] -[require treectrl 2.1.1] +[require treectrl 2.2] [description] [list_begin definitions] @@ -465,12 +465,12 @@ for the column specified by the [call [arg pathName] [cmd {column configure}] [arg columnDesc] \ [opt [arg option]] [opt [arg value]] [opt [arg {option value ...}]]] This command is similar to the [cmd configure] widget command except -that it modifies options associated with the column specified by the +that it modifies options associated with the columns specified by the [sectref {COLUMN DESCRIPTION} {column description}] [arg columnDesc] instead of modifying options for the overall treectrl widget. [arg ColumnDesc] may be the string [const tail] to specify the tail column. -If [arg columnDesc] is the string [const all], at least one option-value pair -must be given; in this case all the columns are configured. +If [arg columnDesc] refers to more than one column, then at least one option-value pair +must be given. If no [arg option] is specified, the command returns a list describing all of the available options for [arg columnDesc] (see [fun Tk_ConfigureInfo] for information on the format of this list). @@ -495,11 +495,13 @@ 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 +[call [arg pathName] [cmd {column count}] [opt [arg columnDesc]]] +If no additional arguments are given, the result is 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 +deleted by the [cmd "column delete"] widget command; in this case the [const tail] column is not counted. +If [arg columnDesc] is given, then the result is the number of columns that +match that [sectref {COLUMN DESCRIPTION} {column description}]. [call [arg pathName] [cmd {column create}] [opt [arg {option value ...}]]] This command creates a new column in the treectrl widget. The new column is @@ -676,7 +678,8 @@ The following forms of the command are supported: [list_begin definitions] [call [arg pathName] [cmd {debug alloc}]] -Returns a string giving partial statistics on memory allocations. +Returns a string giving partial statistics on memory allocations, if the package +was built with TREECTRL_DEBUG defined. [call [arg pathName] [cmd {debug cget}] [arg option]] This command returns the current value of the debugging option @@ -755,12 +758,12 @@ Returns a string useful for debugging vertical scrolling. [list_end] [call [arg pathName] [cmd depth] [opt [arg itemDesc]]] -If the additional argument [arg itemDesc] is specified, -returns a decimal string giving the depth of -the item describing by [arg itemDesc], whereas depth is defined as -the number of steps you must go upward to reach to root item. -If no [arg itemDesc] is specified, the maximum depth of all +If the additional argument [arg itemDesc] is given, +then the result is a decimal string giving the depth of +the item described by [arg itemDesc]. +If no [arg itemDesc] is specified, then the maximum depth of all items in the treectrl widget is returned instead. +Depth is defined as the number of ancestors an item has. [call [arg pathName] [cmd dragimage] [arg option] [opt [arg {arg ...}]]] This command is used to manipulate the dragimage, @@ -964,20 +967,12 @@ of the item specified by [arg itemDesc] in the correct order from the first child to the last child. [call [arg pathName] [cmd {item collapse}] [arg itemDesc] [opt [option -recurse]]] -Switches off the [const open] state of the item(s) -described by [arg itemDesc]. -If the item has descendants, they are no longer displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options [option -buttonimage] or [option -buttonbitmap], -or a [emph +] sign if no image or bitmap is configured. -If the item is already closed, this command has no effect. -[arg ItemDesc] may also be the string [const all], -in which case all items of the treectrl widget are collapsed. -If [option -recurse] is specified, all descendants of [arg itemDesc] -will also be collapsed. -For every item, that actually will be collapsed, -two events are generated: +Switches off the [const open] state of the item(s) described by [arg itemDesc]. +If an item has descendants, then they are no longer displayed. +If an item is already closed, then this command has no effect on that item. +If [option -recurse] is specified, then all descendants of the items described +by [arg itemDesc] will also be collapsed. +For every item that actually will be collapsed, two events are generated: a [const <Collapse-before>] event before the item state is changed, and a [const <Collapse-after>] event after the item state was changed. @@ -995,7 +990,7 @@ This horrible command is now deprecated. Use [cmd {item element configure}] instead. For every column of the treectrl there may be specified one [arg list]. Each [arg list] should look like this: [example_begin] -{ {element option value...} {element option value...} ...} +{ {element option value ...} {element option value ...} ...} [example_end] Every [arg option] must be known by the element's type (see [sectref ELEMENTS] below). @@ -1027,14 +1022,13 @@ the meaning of each option): [list_end] -[call [arg pathName] [cmd {item count}] [opt [arg -visible]]] -Returns a decimal string giving the number of +[call [arg pathName] [cmd {item count}] [opt [arg itemDesc]]] +If no additional arguments are given, the result is 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. If the optional argument [arg -visible] is given, only the items -whose ancestors are expanded, and whose -visible option is true, get counted. -Additionally, for the root item, the treectrl option [option -showroot] must -be true for the root item to be counted. +root item. +If the optional argument [arg itemDesc] is given, then the result is the +number of items that match that [sectref {ITEM DESCRIPTION} {item description}]. [call [arg pathName] [cmd {item create}] [opt [arg {option value ...}]]] Creates some new items and optionally returns a list of unique identifiers for @@ -1053,7 +1047,8 @@ indicates whether or not an expand/collapse button should be drawn next to this item, typically to indicate the item has children. The button will only be displayed if: a) the column specified by the treectrl option [option -treecolumn] is visible; -and b) the treectrl option [option -showbuttons] is true +and b) the treectrl option [option -showbuttons] is true; +and c) for the root item, the treectrl option [option -showrootbutton] is true. [opt_def [option -count] [arg numItems]] Specifies the number of items to create. Must be >= 0. Defaults to 1. @@ -1114,7 +1109,7 @@ in all cases the specification of the root item is ignored. For each call to this command, two events may be generated. If any of the deleted items are selected, then a [const <Selection>] event is generated just before the items are deleted. -If any items were actually deleted, then an [const <ItemDelete>] event event is generated just before the items +If any items are going to be deleted, then an [const <ItemDelete>] event event is generated just before the items are deleted. [call [arg pathName] [cmd {item descendants}] [arg itemDesc]] @@ -1195,21 +1190,16 @@ Returns 1 if the item described by [arg itemDesc] has the state [const enabled] switched on, 0 otherwise. If [arg boolean] is specified, then the [const enabled] state of every item described by the [sectref {ITEM DESCRIPTION} {item description}] [arg itemDesc] is set accordingly. +All items are enabled when first created. Disabled items cannot be selected, +and are ignored by the default key-navigation and mouse bindings. [call [arg pathName] [cmd {item expand}] [arg itemDesc] [opt [option -recurse]]] Switches on the [const open] state of the item(s) described by [arg itemDesc]. -If the item has descendants, they are now displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options [option -buttonimage] or [option -buttonbitmap], -or a [emph -] sign if no image or bitmap is configured. -If the item is already open, this command has no effect. -[arg ItemDesc] may also be the string [const all], -in which case all items of the treectrl widget are expanded. -If [option -recurse] is specified, all descendants of [arg itemDesc] -will also be expanded. -For every item, that actually will be expanded, -two events are generated: +If an item has descendants, then they are now displayed. +If an item is already open, then this command has no effect on that item. +If [option -recurse] is specified, then all descendants of the items described by +[arg itemDesc] will also be expanded. +For every item that actually will be expanded, two events are generated: an [const <Expand-before>] event before the item state is changed, and an [const <Expand-after>] event after the item state was changed. @@ -1527,13 +1517,11 @@ want to set or retrieve the value of the -text option for a specific text elemen [call [arg pathName] [cmd {item toggle}] [arg itemDesc] [opt [option -recurse]]] Changes the [const open] state of the item(s) described by [arg itemDesc]. -If the state is currently switched off, -this command does the same as the [cmd {item expand}] widget command, +If the [const open] state is currently switched off, then +this command does the same as the [cmd {item expand}] widget command; otherwise the same as the [cmd {item collapse}] widget command. -[arg ItemDesc] may also be the string [const all], -in which case the state of all items of the treectrl widget are toggled. -If [option -recurse] is specified, the state of all descendants of -[arg itemDesc] will also be toggled. +If [option -recurse] is specified, then the [const open] state of all descendants of +the items described by [arg itemDesc] will also be toggled. [list_end] @@ -1605,15 +1593,19 @@ If two coordinates are specified, sets the corner to the given coordinates [arg x] and [arg y]. [call [arg pathName] [cmd {marquee identify}]] -Returns a list with information about the items inside the marquee. -The list has as elements a list itself -for every item which is displayed inside the marquee. -The first element of these lists is the numerical item id, -followed by another list with information about every column of the -item inside the marque. -These lists start with the column number, -followed by the elements of the style defined for the item in this column -if there are any. +Returns a list with information about any items intersecting the marquee. +The format of the returned list is: +[example_begin] +{ + {item {column element element ...} {column element element ...} ...} + {item {column element element ...} {column element element ...} ...} + ... +} +[example_end] +There may be zero sublists following an item id if the marquee is in the +button/line area of an item. There may be zero element names following a +column id if the item-column has no style or if the marquee does not +intersect any elements in that column. [list_end] @@ -2276,8 +2268,10 @@ determines this). The value may have any of the forms acceptable to [fun Tk_GetPixels]. [opt_def [option -button] [arg boolean]] -Indicates whether or not a mouse click on the column header should -change the sorting order of the tree. +Indicates whether or not the column header should be treated like a pushbutton. +When this option is true, the default bindings track <Button-1> events +in the header and generate a <Header-invoke> event when a <ButtonRelease-1> +event occurs in the header. See [sectref {DYNAMIC EVENTS}]. [opt_def [option -expand] [arg boolean]] Indicates whether or not any extra horizontal space should be distributed @@ -2336,7 +2330,7 @@ This option has no effect if the [option -width] option is set. [opt_def [option -resize] [arg boolean]] Specifies a boolean value that indicates whether the user should be allowed to -resize the column by dragging the right edge of the column's header. Default is true. +resize the column by dragging the edge of the column's header. Default is true. [opt_def [option -squeeze] [arg boolean]] Specifies a boolean value that indicates whether or not the column should @@ -2445,7 +2439,7 @@ This keyword cannot be followed by any modifiers unless a single column is matched. You may run into trouble if [arg tagExpr] looks like a column id or other keyword; also, [arg tagExpr] must look like a single list element since column descriptions are properly-formed lists. To be safe you may want to -use the [const tag] keyword followed by [arg tagExpr]. +use the [const tag] qualifier followed by [arg tagExpr]. [lst_item "[const all] [arg QUALIFIERS]"] Indicates every column, including the tail column if the command allows it, @@ -2929,7 +2923,7 @@ This keyword cannot be followed by any modifiers unless a single item is matched. You may run into trouble if [arg tagExpr] looks like an item id or other keyword; also, [arg tagExpr] must look like a single list element since item descriptions are properly-formed lists. To be safe you may want to -use the [const tag] keyword followed by [arg tagExpr]. +use the [const tag] qualifier followed by [arg tagExpr]. [lst_item [const active]] Indicates the item that is currently active, i.e. normally diff --git a/doc/treectrl.n b/doc/treectrl.n index ae293dd..da1e794 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.57 2006/11/03 22:31:05 treectrl Exp $ +'\" $Id: treectrl.n,v 1.58 2006/11/18 04:40:10 treectrl Exp $ .so man.macros -.TH "treectrl" n 2.1.1 treectrl "Tk Commands" +.TH "treectrl" n 2.2 treectrl "Tk Commands" .BS .SH "NAME" treectrl \- Create and manipulate hierarchical multicolumn widgets .SH "SYNOPSIS" -package require \fBtreectrl 2.1.1\fR +package require \fBtreectrl 2.2\fR .sp \fBtreectrl\fR \fIpathName\fR ?\fIoptions\fR? .sp @@ -37,7 +37,7 @@ package require \fBtreectrl 2.1.1\fR .sp \fIpathName\fR \fBcolumn compare\fR \fIcolumn1\fR \fIop\fR \fIcolumn2\fR .sp -\fIpathName\fR \fBcolumn count\fR +\fIpathName\fR \fBcolumn count\fR ?\fIcolumnDesc\fR? .sp \fIpathName\fR \fBcolumn create\fR ?\fIoption value ...\fR? .sp @@ -145,7 +145,7 @@ package require \fBtreectrl 2.1.1\fR .sp \fIpathName\fR \fBitem configure\fR \fIitemDesc\fR ?\fIoption\fR? ?\fIvalue\fR? ?\fIoption value ...\fR? .sp -\fIpathName\fR \fBitem count\fR ?\fI-visible\fR? +\fIpathName\fR \fBitem count\fR ?\fIitemDesc\fR? .sp \fIpathName\fR \fBitem create\fR ?\fIoption value ...\fR? .sp @@ -1082,12 +1082,12 @@ for the column specified by the .TP \fIpathName\fR \fBcolumn configure\fR \fIcolumnDesc\fR ?\fIoption\fR? ?\fIvalue\fR? ?\fIoption value ...\fR? This command is similar to the \fBconfigure\fR widget command except -that it modifies options associated with the column specified by the +that it modifies options associated with the columns specified by the \fBcolumn description\fR \fIcolumnDesc\fR instead of modifying options for the overall treectrl widget. \fIColumnDesc\fR may be the string \fBtail\fR to specify the tail column. -If \fIcolumnDesc\fR is the string \fBall\fR, at least one option-value pair -must be given; in this case all the columns are configured. +If \fIcolumnDesc\fR refers to more than one column, then at least one option-value pair +must be given. If no \fIoption\fR is specified, the command returns a list describing all of the available options for \fIcolumnDesc\fR (see \fBTk_ConfigureInfo\fR for information on the format of this list). @@ -1111,11 +1111,13 @@ 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 -Returns a decimal string giving the number of +\fIpathName\fR \fBcolumn count\fR ?\fIcolumnDesc\fR? +If no additional arguments are given, the result is 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 +deleted by the \fBcolumn delete\fR widget command; in this case the \fBtail\fR column is not counted. +If \fIcolumnDesc\fR is given, then the result is the number of columns that +match that \fBcolumn description\fR. .TP \fIpathName\fR \fBcolumn create\fR ?\fIoption value ...\fR? This command creates a new column in the treectrl widget. The new column is @@ -1286,7 +1288,8 @@ The following forms of the command are supported: .RS .TP \fIpathName\fR \fBdebug alloc\fR -Returns a string giving partial statistics on memory allocations. +Returns a string giving partial statistics on memory allocations, if the package +was built with TREECTRL_DEBUG defined. .TP \fIpathName\fR \fBdebug cget\fR \fIoption\fR This command returns the current value of the debugging option @@ -1364,12 +1367,12 @@ Returns a string useful for debugging vertical scrolling. .RE .TP \fIpathName\fR \fBdepth\fR ?\fIitemDesc\fR? -If the additional argument \fIitemDesc\fR is specified, -returns a decimal string giving the depth of -the item describing by \fIitemDesc\fR, whereas depth is defined as -the number of steps you must go upward to reach to root item. -If no \fIitemDesc\fR is specified, the maximum depth of all +If the additional argument \fIitemDesc\fR is given, +then the result is a decimal string giving the depth of +the item described by \fIitemDesc\fR. +If no \fIitemDesc\fR is specified, then the maximum depth of all items in the treectrl widget is returned instead. +Depth is defined as the number of ancestors an item has. .TP \fIpathName\fR \fBdragimage\fR \fIoption\fR ?\fIarg ...\fR? This command is used to manipulate the dragimage, @@ -1561,20 +1564,12 @@ of the item specified by \fIitemDesc\fR in the correct order from the first child to the last child. .TP \fIpathName\fR \fBitem collapse\fR \fIitemDesc\fR ?\fB-recurse\fR? -Switches off the \fBopen\fR state of the item(s) -described by \fIitemDesc\fR. -If the item has descendants, they are no longer displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options \fB-buttonimage\fR or \fB-buttonbitmap\fR, -or a \fI+\fR sign if no image or bitmap is configured. -If the item is already closed, this command has no effect. -\fIItemDesc\fR may also be the string \fBall\fR, -in which case all items of the treectrl widget are collapsed. -If \fB-recurse\fR is specified, all descendants of \fIitemDesc\fR -will also be collapsed. -For every item, that actually will be collapsed, -two events are generated: +Switches off the \fBopen\fR state of the item(s) described by \fIitemDesc\fR. +If an item has descendants, then they are no longer displayed. +If an item is already closed, then this command has no effect on that item. +If \fB-recurse\fR is specified, then all descendants of the items described +by \fIitemDesc\fR will also be collapsed. +For every item that actually will be collapsed, two events are generated: a \fB<Collapse-before>\fR event before the item state is changed, and a \fB<Collapse-after>\fR event after the item state was changed. .TP @@ -1593,7 +1588,7 @@ instead. For every column of the treectrl there may be specified one \fIlist\fR. Each \fIlist\fR should look like this: .nf -{ {element option value...} {element option value...} ...} +{ {element option value ...} {element option value ...} ...} .fi Every \fIoption\fR must be known by the element's type @@ -1627,14 +1622,13 @@ the meaning of each option): \fB\fB-visible\fR\fR \fIboolean\fR .RE .TP -\fIpathName\fR \fBitem count\fR ?\fI-visible\fR? -Returns a decimal string giving the number of +\fIpathName\fR \fBitem count\fR ?\fIitemDesc\fR? +If no additional arguments are given, the result is 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. If the optional argument \fI-visible\fR is given, only the items -whose ancestors are expanded, and whose -visible option is true, get counted. -Additionally, for the root item, the treectrl option \fB-showroot\fR must -be true for the root item to be counted. +root item. +If the optional argument \fIitemDesc\fR is given, then the result is the +number of items that match that \fBitem description\fR. .TP \fIpathName\fR \fBitem create\fR ?\fIoption value ...\fR? Creates some new items and optionally returns a list of unique identifiers for @@ -1652,7 +1646,8 @@ indicates whether or not an expand/collapse button should be drawn next to this item, typically to indicate the item has children. The button will only be displayed if: a) the column specified by the treectrl option \fB-treecolumn\fR is visible; -and b) the treectrl option \fB-showbuttons\fR is true +and b) the treectrl option \fB-showbuttons\fR is true; +and c) for the root item, the treectrl option \fB-showrootbutton\fR is true. .TP \fB\fB-count\fR\fR \fInumItems\fR Specifies the number of items to create. Must be >= 0. Defaults to 1. @@ -1712,7 +1707,7 @@ in all cases the specification of the root item is ignored. For each call to this command, two events may be generated. If any of the deleted items are selected, then a \fB<Selection>\fR event is generated just before the items are deleted. -If any items were actually deleted, then an \fB<ItemDelete>\fR event event is generated just before the items +If any items are going to be deleted, then an \fB<ItemDelete>\fR event event is generated just before the items are deleted. .TP \fIpathName\fR \fBitem descendants\fR \fIitemDesc\fR @@ -1788,21 +1783,16 @@ Returns 1 if the item described by \fIitemDesc\fR has the state \fBenabled\fR switched on, 0 otherwise. If \fIboolean\fR is specified, then the \fBenabled\fR state of every item described by the \fBitem description\fR \fIitemDesc\fR is set accordingly. +All items are enabled when first created. Disabled items cannot be selected, +and are ignored by the default key-navigation and mouse bindings. .TP \fIpathName\fR \fBitem expand\fR \fIitemDesc\fR ?\fB-recurse\fR? Switches on the \fBopen\fR state of the item(s) described by \fIitemDesc\fR. -If the item has descendants, they are now displayed. -If the item is configured to have a button, -the button will now display the image or bitmap configured with the -widget options \fB-buttonimage\fR or \fB-buttonbitmap\fR, -or a \fI-\fR sign if no image or bitmap is configured. -If the item is already open, this command has no effect. -\fIItemDesc\fR may also be the string \fBall\fR, -in which case all items of the treectrl widget are expanded. -If \fB-recurse\fR is specified, all descendants of \fIitemDesc\fR -will also be expanded. -For every item, that actually will be expanded, -two events are generated: +If an item has descendants, then they are now displayed. +If an item is already open, then this command has no effect on that item. +If \fB-recurse\fR is specified, then all descendants of the items described by +\fIitemDesc\fR will also be expanded. +For every item that actually will be expanded, two events are generated: an \fB<Expand-before>\fR event before the item state is changed, and an \fB<Expand-after>\fR event after the item state was changed. .TP @@ -2095,13 +2085,11 @@ want to set or retrieve the value of the -text option for a specific text elemen .TP \fIpathName\fR \fBitem toggle\fR \fIitemDesc\fR ?\fB-recurse\fR? Changes the \fBopen\fR state of the item(s) described by \fIitemDesc\fR. -If the state is currently switched off, -this command does the same as the \fBitem expand\fR widget command, +If the \fBopen\fR state is currently switched off, then +this command does the same as the \fBitem expand\fR widget command; otherwise the same as the \fBitem collapse\fR widget command. -\fIItemDesc\fR may also be the string \fBall\fR, -in which case the state of all items of the treectrl widget are toggled. -If \fB-recurse\fR is specified, the state of all descendants of -\fIitemDesc\fR will also be toggled. +If \fB-recurse\fR is specified, then the \fBopen\fR state of all descendants of +the items described by \fIitemDesc\fR will also be toggled. .RE .TP \fIpathName\fR \fBmarquee\fR \fIoption\fR ?\fIarg ...\fR? @@ -2170,15 +2158,21 @@ If two coordinates are specified, sets the corner to the given coordinates \fIx\fR and \fIy\fR. .TP \fIpathName\fR \fBmarquee identify\fR -Returns a list with information about the items inside the marquee. -The list has as elements a list itself -for every item which is displayed inside the marquee. -The first element of these lists is the numerical item id, -followed by another list with information about every column of the -item inside the marque. -These lists start with the column number, -followed by the elements of the style defined for the item in this column -if there are any. +Returns a list with information about any items intersecting the marquee. +The format of the returned list is: +.nf + +{ + {item {column element element ...} {column element element ...} ...} + {item {column element element ...} {column element element ...} ...} + ... +} + +.fi +There may be zero sublists following an item id if the marquee is in the +button/line area of an item. There may be zero element names following a +column id if the item-column has no style or if the marquee does not +intersect any elements in that column. .RE .TP \fIpathName\fR \fBnotify\fR \fIoption\fR ?\fIarg ...\fR? @@ -2816,8 +2810,10 @@ determines this). The value may have any of the forms acceptable to \fBTk_GetPixels\fR. .TP \fB\fB-button\fR\fR \fIboolean\fR -Indicates whether or not a mouse click on the column header should -change the sorting order of the tree. +Indicates whether or not the column header should be treated like a pushbutton. +When this option is true, the default bindings track <Button-1> events +in the header and generate a <Header-invoke> event when a <ButtonRelease-1> +event occurs in the header. See \fBDYNAMIC EVENTS\fR. .TP \fB\fB-expand\fR\fR \fIboolean\fR Indicates whether or not any extra horizontal space should be distributed @@ -2876,7 +2872,7 @@ This option has no effect if the \fB-width\fR option is set. .TP \fB\fB-resize\fR\fR \fIboolean\fR Specifies a boolean value that indicates whether the user should be allowed to -resize the column by dragging the right edge of the column's header. Default is true. +resize the column by dragging the edge of the column's header. Default is true. .TP \fB\fB-squeeze\fR\fR \fIboolean\fR Specifies a boolean value that indicates whether or not the column should @@ -2981,7 +2977,7 @@ This keyword cannot be followed by any modifiers unless a single column is matched. You may run into trouble if \fItagExpr\fR looks like a column id or other keyword; also, \fItagExpr\fR must look like a single list element since column descriptions are properly-formed lists. To be safe you may want to -use the \fBtag\fR keyword followed by \fItagExpr\fR. +use the \fBtag\fR qualifier followed by \fItagExpr\fR. .TP \fBall\fR \fIQUALIFIERS\fR Indicates every column, including the tail column if the command allows it, @@ -3429,7 +3425,7 @@ This keyword cannot be followed by any modifiers unless a single item is matched. You may run into trouble if \fItagExpr\fR looks like an item id or other keyword; also, \fItagExpr\fR must look like a single list element since item descriptions are properly-formed lists. To be safe you may want to -use the \fBtag\fR keyword followed by \fItagExpr\fR. +use the \fBtag\fR qualifier followed by \fItagExpr\fR. .TP \fBactive\fR Indicates the item that is currently active, i.e. normally |