From 1f19943e4ce1b8520794fd8745fab749e0fc35ac Mon Sep 17 00:00:00 2001 From: treectrl Date: Tue, 6 Feb 2007 22:32:01 +0000 Subject: Notes for 2.2.3. --- doc/What's New in TkTreeCtrl.html | 4129 ++++++++++++++++++++++++++++++++----- 1 file changed, 3575 insertions(+), 554 deletions(-) diff --git a/doc/What's New in TkTreeCtrl.html b/doc/What's New in TkTreeCtrl.html index 2df1413..ac78ffd 100644 --- a/doc/What's New in TkTreeCtrl.html +++ b/doc/What's New in TkTreeCtrl.html @@ -1,7 +1,7 @@ - + @@ -13,6 +13,12 @@ + + + + + + @@ -34,6 +40,9 @@ + + + @@ -56,6 +65,12 @@ + + + + + + What's New in TkTreeCtrl @@ -64,15 +79,33 @@ +

What's New in TkTreeCtrl 2.2.3

+ + +

Build Changes

When building with configure on Windows the --enable-shellicon option will run configure in the shellicon/ subdirectory.
'make dist' will create the source distribution tktreectrl-VERSION.tar.gz.
'make dist-win' will create the Windows binary distribution tktreectrl-VERSION-win32.zip.

Bug Fixes

Fixed flickering when redrawing the borders with "-doublebuffer window" when the widget was resized or parts of it were exposed.
Fixed undefined reference to vsnprintf when building with the MS compiler under Windows; it should be _vsnprintf.
Fixed a symbol conflict with Python 2.5 on ELF-based systems which also defines a symbol "Ellipsis".

+ +

What's New in TkTreeCtrl 2.2.2

@@ -83,6 +116,9 @@ + + +

Column Configuration Options

@@ -92,6 +128,9 @@ + + + @@ -101,6 +140,9 @@ + + + @@ -110,6 +152,9 @@ + + + @@ -119,6 +164,9 @@ + + + @@ -128,6 +176,9 @@ + + + @@ -137,6 +188,9 @@ + + + @@ -146,6 +200,9 @@ + + + @@ -155,6 +212,9 @@ + + + @@ -164,6 +224,9 @@ + + + @@ -185,6 +251,12 @@ according to the -justify option of the + + + + + + @@ -203,6 +275,9 @@ according to the -justify option of the + + +

Item Configuration Options

@@ -213,6 +288,9 @@ according to the -justify option of the + + +

New	Comment
-itemjustify	This option allows item styles to be justified separately from the image/text in the column header. If the value of this option is unspecified (the default), then item styles are justified @@ -176,6 +239,9 @@ according to the -justify option of the + + +

@@ -223,6 +301,9 @@ according to the -justify option of the + + + @@ -233,6 +314,9 @@ according to the -justify option of the + + + @@ -243,6 +327,9 @@ according to the -justify option of the + + + @@ -254,6 +341,9 @@ Changed + + + @@ -265,6 +355,9 @@ it changed + + + @@ -275,6 +368,9 @@ it changed + + + @@ -285,6 +381,9 @@ it changed + + + @@ -295,6 +394,9 @@ it changed + + + @@ -305,6 +407,9 @@ it changed + + + @@ -315,6 +420,12 @@ it changed + + + + + + @@ -335,6 +446,9 @@ it changed + + +

Style Layout Changes

@@ -345,6 +459,9 @@ it changed + + +

The element option -draw of every element type is now deprecated. Use the new style layout option -draw instead.
The new per-state style layout option -visible controls the visibility of an element. When the value of this option evaluates to false for a given state, the element consumes no space in @@ -374,6 +497,9 @@ the layout and is not displayed. If none of the elements surrounded by an elemen + + +

@@ -384,6 +510,9 @@ the layout and is not displayed. If none of the elements surrounded by an elemen + + +

Item Descriptions

@@ -394,6 +523,9 @@ the layout and is not displayed. If none of the elements surrounded by an elemen + + +

The index argument to the child and sibling modifiers can now take the form "end?-integer?".

@@ -424,6 +562,9 @@ the layout and is not displayed. If none of the elements surrounded by an elemen + + +

.t item id "root child end-1" ; # get the second-to-last child of the root item

@@ -433,6 +574,9 @@ the layout and is not displayed. If none of the elements surrounded by an elemen + + +

@@ -441,6 +585,9 @@ the layout and is not displayed. If none of the elements surrounded by an elemen + + +

Bug Fixes

@@ -449,6 +596,9 @@ the layout and is not displayed. If none of the elements surrounded by an elemen + + +

Text elements were requesting some height from the style layout when displaying an empty string. If you were depending on this behaviour, it is suggested that you set the height of the text element using the -minheight or -height style layout options.
Window elements might not be scrolled along with the rest of the list if the area needing to be redrawn due to scrolling was obscurred by other windows. This could only happen on Win32.
The ellipsis "..." in text elements is now always displayed if the text element has less space than is needed to display its string. Previously the ellipsis would disappear when there wasn't room for a single character plus the ellipsis.
Fixed a layout bug with multi-line text elements when the unsqueezed element did not require a multi-line layout but the squeezed element did.

@@ -495,6 +660,9 @@ element did. + + +

What's New in TkTreeCtrl 2.2.1

@@ -502,43 +670,67 @@ element did. + + +

Bug Fixes

+ + +

Fixed panic with -xscrollincrement=0, -showheader=yes, no visible items and headers wider than the window.
Fixed the wrong loop variable being used when calculating onscreen columns for an item which resulted in a random crash.
Fixed a crash when invalidating a column of an item if the column wasn't the first in a span.
Fixed a leak on X11 where the clipping region was not being freed after drawing dotted rectangles.

+ + +

What's New in TkTreeCtrl 2.2

@@ -552,6 +744,9 @@ element did. + + +

TreeCtrl Configuration Options

@@ -564,6 +759,9 @@ element did. + + +

Usage Changed	How it changed
-button	The value of this option can now be the word auto (or any abbreviation) in which case a button is drawn only when the item has at least one child item with its item option -visible set to true.

@@ -576,6 +774,9 @@ element did. + + + @@ -588,6 +789,9 @@ element did. + + + @@ -600,6 +804,9 @@ element did. + + + @@ -612,6 +819,9 @@ element did. + + + @@ -626,6 +836,9 @@ instead + + + @@ -638,6 +851,9 @@ instead + + + @@ -650,6 +866,9 @@ instead + + + @@ -662,6 +881,9 @@ instead + + + @@ -674,6 +896,9 @@ instead + + + @@ -686,6 +911,12 @@ instead + + + + + + @@ -709,10 +940,10 @@ instead -

TreeCtrl Command

@@ -721,19 +952,18 @@ instead -

Deprecated	What to use instead
-defaultstyle	The -itemstyle option of a column.

- @@ -743,9 +973,9 @@ instead + - @@ -757,9 +987,8 @@ instead - + @@ -770,12 +999,12 @@ Changed - + @@ -783,7 +1012,6 @@ changed - @@ -791,11 +1019,12 @@ changed + - @@ -806,8 +1035,8 @@ changed + - @@ -819,12 +1048,9 @@ changed - + @@ -834,19 +1060,18 @@ small. - + - @@ -855,10 +1080,58 @@ small. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - @@ -883,6 +1156,12 @@ the selection. For example:
+ + + + + + @@ -905,6 +1184,9 @@ the selection. For example:
+ + + @@ -917,6 +1199,9 @@ the selection. For example:
+ + + @@ -929,6 +1214,9 @@ the selection. For example:
+ + + @@ -941,6 +1229,9 @@ the selection. For example:
+ + + @@ -953,6 +1244,9 @@ the selection. For example:
+ + + @@ -965,6 +1259,9 @@ the selection. For example:
+ + + @@ -977,6 +1274,9 @@ the selection. For example:
+ + + @@ -989,6 +1289,9 @@ the selection. For example:
+ + + @@ -1001,6 +1304,9 @@ the selection. For example:
+ + + @@ -1150,6 +1492,9 @@ will return the bounds of the left-locked and right-locked columns. + + + @@ -1162,6 +1507,12 @@ will return the bounds of the left-locked and right-locked columns. + + + + + + @@ -1185,6 +1536,9 @@ will return the bounds of the left-locked and right-locked columns. + + +

Column Configuration Options

@@ -1197,6 +1551,9 @@ will return the bounds of the left-locked and right-locked columns. + + +

Arguments/Result -Changed
What -changed	Arguments/Result +Changed
What +changed
contentbox	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.
contentbox
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.
selection get	selection get
New	Comment
bbox	Returns the bounding box of different areas of the window. For example: @@ -1014,6 +1320,12 @@ window. For example: + + + + + + @@ -1036,6 +1348,9 @@ window. For example: + + + will return the bounds of the window, and: @@ -1048,6 +1363,12 @@ will return the bounds of the window, and: + + + + + + @@ -1070,6 +1391,9 @@ will return the bounds of the window, and: + + + will return the bounds of the column headers, and: @@ -1082,6 +1406,12 @@ will return the bounds of the column headers, and: + + + + + + @@ -1104,6 +1434,9 @@ will return the bounds of the column headers, and: + + + will return the same result as the [contentbox] command, and: @@ -1116,6 +1449,12 @@ will return the same result as the [contentbox] command, and: + + + + + + @@ -1138,6 +1477,9 @@ will return the same result as the [contentbox] command, and: + + + will return the bounds of the left-locked and right-locked columns.

@@ -1209,6 +1566,9 @@ will return the bounds of the left-locked and right-locked columns. + + + @@ -1221,6 +1581,9 @@ will return the bounds of the left-locked and right-locked columns. + + + @@ -1233,6 +1596,9 @@ will return the bounds of the left-locked and right-locked columns. + + + @@ -1257,6 +1626,9 @@ will return the bounds of the left-locked and right-locked columns. + + + @@ -1270,6 +1642,9 @@ name + + + @@ -1282,6 +1657,9 @@ name + + + @@ -1294,6 +1672,9 @@ name + + + @@ -1306,6 +1687,9 @@ name + + + @@ -1318,6 +1702,9 @@ name + + + @@ -1330,6 +1717,9 @@ name + + + @@ -1342,6 +1732,9 @@ name + + + @@ -1354,6 +1747,9 @@ name + + + @@ -1366,6 +1762,9 @@ name + + + @@ -1378,6 +1777,9 @@ name + + + @@ -1390,6 +1792,9 @@ name + + + @@ -1402,6 +1807,9 @@ name + + + @@ -1429,6 +1840,9 @@ horizontally. Valid values for this option are + + + @@ -1441,6 +1855,9 @@ horizontally. Valid values for this option are + + + @@ -1453,6 +1870,9 @@ horizontally. Valid values for this option are + + + @@ -1467,6 +1887,9 @@ newly-created items. This option replaces the treectrl option + + + @@ -1479,6 +1902,9 @@ newly-created items. This option replaces the treectrl option + + + @@ -1491,6 +1917,9 @@ newly-created items. This option replaces the treectrl option + + + @@ -1503,6 +1932,9 @@ newly-created items. This option replaces the treectrl option + + + @@ -1621,6 +2080,9 @@ will give column 0 twice the extra space as column 1. + + + @@ -1633,6 +2095,9 @@ will give column 0 twice the extra space as column 1. + + + @@ -1645,6 +2110,9 @@ will give column 0 twice the extra space as column 1. + + + @@ -1657,6 +2125,9 @@ will give column 0 twice the extra space as column 1. + + + @@ -1669,6 +2140,12 @@ will give column 0 twice the extra space as column 1. + + + + + + @@ -1692,10 +2169,10 @@ will give column 0 twice the extra space as column 1. -

Column Command

@@ -1704,19 +2181,18 @@ will give column 0 twice the extra space as column 1. -

Renamed @@ -1245,6 +1611,9 @@ will return the bounds of the left-locked and right-locked columns. + + +	New name
-tag	-tags
New	Comment
-lock	This option allows columns to stick to the left or right edge of the window. Locked columns can scroll vertically but not @@ -1417,6 +1825,9 @@ horizontally. Valid values for this option are + + +
-itemstyle	Specifies the name of a style to set in this column for newly-created items. This option replaces the treectrl option -defaultstyle.
-uniform	These two options operate the same as the grid geometry manager options of the same name. For example: @@ -1517,6 +1949,12 @@ For example: + + + + + + @@ -1539,6 +1977,9 @@ For example: + + + will give columns 0 and 1 the same requested width, whichever is the larger of the two columns. And: @@ -1552,6 +1993,12 @@ larger of the two columns. And: + + + + + + @@ -1574,6 +2021,9 @@ larger of the two columns. And: + + + will give column 0 twice the maximum of the requested widths of columns 0 and 1. And: @@ -1587,6 +2037,12 @@ will give column 0 twice the maximum of the requested widths of columns + + + + + + @@ -1609,6 +2065,9 @@ will give column 0 twice the maximum of the requested widths of columns + + + will give column 0 twice the extra space as column 1.
-weight

- @@ -1726,9 +2202,25 @@ will give column 0 twice the extra space as column 1. + + + + + + + + + + + + + + + + + - @@ -1753,6 +2245,9 @@ Changed + + + @@ -1766,6 +2261,9 @@ changed + + + @@ -1778,6 +2276,9 @@ changed + + + @@ -1790,6 +2291,9 @@ changed + + + @@ -1802,6 +2306,9 @@ changed + + + @@ -1885,6 +2410,9 @@ both. + + + @@ -1897,6 +2425,9 @@ both. + + + @@ -1909,6 +2440,9 @@ both. + + + @@ -1921,6 +2455,9 @@ both. + + + @@ -1933,6 +2470,9 @@ both. + + + @@ -1945,6 +2485,9 @@ both. + + + @@ -1957,6 +2500,9 @@ both. + + + @@ -1969,6 +2515,9 @@ both. + + + + + + @@ -1996,6 +2548,9 @@ word "tail" in column descriptions. + + + @@ -2008,6 +2563,9 @@ word "tail" in column descriptions. + + + @@ -2020,6 +2578,9 @@ word "tail" in column descriptions. + + + @@ -2032,6 +2593,9 @@ word "tail" in column descriptions. + + + @@ -2044,6 +2608,9 @@ word "tail" in column descriptions. + + + @@ -2056,6 +2623,9 @@ word "tail" in column descriptions. + + + @@ -2068,6 +2638,9 @@ word "tail" in column descriptions. + + + @@ -2080,6 +2653,9 @@ word "tail" in column descriptions. + + + @@ -2092,6 +2668,9 @@ word "tail" in column descriptions. + + + @@ -2104,6 +2683,12 @@ word "tail" in column descriptions. + + + + + + @@ -2127,6 +2712,9 @@ word "tail" in column descriptions. + + +

Item Configuration Options

@@ -2139,6 +2727,9 @@ word "tail" in column descriptions. + + +

What changed
column count	Takes an optional column-description argument; the result is the number of columns that match the column description. For example: @@ -1816,6 +2323,12 @@ the number of columns that match the column description. For example: + + + + + + @@ -1838,6 +2351,9 @@ the number of columns that match the column description. For example: + + + will return the number of columns whose -visible option is true, and: @@ -1850,6 +2366,12 @@ will return the number of columns whose -visible option is true, and: + + + + + + @@ -1872,6 +2394,9 @@ will return the number of columns whose -visible option is true, and: + + + will return the number of columns with either tag "a" or "b", but not both.
New	Comment
column tag add	Columns can have a list of tag names. Previously only a single tag was allowed. The tail column no longer has the word "tail" as a tag, but it is still referred to by the @@ -1984,6 +2533,9 @@ word "tail" in column descriptions.
column tag expr
column tag names
column tag remove

@@ -2151,6 +2742,9 @@ word "tail" in column descriptions. + + + @@ -2163,6 +2757,9 @@ word "tail" in column descriptions. + + + @@ -2175,6 +2772,9 @@ word "tail" in column descriptions. + + + @@ -2187,6 +2787,9 @@ word "tail" in column descriptions. + + + @@ -2199,6 +2802,9 @@ word "tail" in column descriptions. + + + @@ -2211,6 +2817,9 @@ word "tail" in column descriptions. + + + @@ -2223,6 +2832,9 @@ word "tail" in column descriptions. + + + @@ -2235,6 +2847,9 @@ word "tail" in column descriptions. + + + + + + @@ -2263,6 +2881,12 @@ found in the man page. + + + + + + @@ -2286,6 +2910,9 @@ found in the man page. + + +

Item Command

@@ -2298,6 +2925,9 @@ found in the man page. + + +

New	Comment
-tags	Tags are textual labels applied to items to group them. Tags do not affect the appearance or behaviour of items. Tags can be used in @@ -2251,6 +2866,9 @@ found in the man page.

@@ -2310,6 +2940,9 @@ found in the man page. + + + @@ -2322,6 +2955,9 @@ found in the man page. + + + @@ -2334,6 +2970,9 @@ found in the man page. + + + @@ -2347,6 +2986,9 @@ Changed + + + @@ -2360,6 +3002,9 @@ changed + + + @@ -2372,6 +3017,9 @@ changed + + + @@ -2384,6 +3032,9 @@ changed + + + @@ -2396,6 +3047,9 @@ changed + + + @@ -2479,6 +3151,9 @@ both. + + + @@ -2491,6 +3166,9 @@ both. + + + @@ -2503,6 +3181,9 @@ both. + + + @@ -2515,6 +3196,9 @@ both. + + + @@ -2528,6 +3212,9 @@ specifies an initial list of tags for created items. + + + @@ -2540,6 +3227,9 @@ specifies an initial list of tags for created items. + + + @@ -2552,6 +3242,9 @@ specifies an initial list of tags for created items. + + + @@ -2564,6 +3257,9 @@ specifies an initial list of tags for created items. + + + - +will return the ids of every child of an item. @@ -2645,7 +3355,6 @@ will return the ids of every child of an item. - @@ -2653,11 +3362,11 @@ will return the ids of every child of an item. + - @@ -2668,8 +3377,8 @@ will return the ids of every child of an item. + - @@ -2681,9 +3390,9 @@ will return the ids of every child of an item. - + @@ -2693,19 +3402,18 @@ will return the ids of every child of an item. - + - @@ -2714,10 +3422,10 @@ will return the ids of every child of an item. + - @@ -2729,8 +3437,7 @@ will return the ids of every child of an item. - + @@ -2742,10 +3449,10 @@ an item. - + @@ -2754,7 +3461,47 @@ an item. - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -2778,6 +3525,9 @@ an item. + + + + + + @@ -2805,6 +3558,9 @@ and mouse bindings. + + + @@ -2817,6 +3573,9 @@ and mouse bindings. + + + @@ -2829,6 +3588,9 @@ and mouse bindings. + + + + + + + + + @@ -2863,6 +3631,9 @@ and mouse bindings. + + + will add tags "a", "b" and "c" to every item.
@@ -2875,6 +3646,9 @@ will add tags "a", "b" and "c" to every item.
+ + + @@ -2887,6 +3661,9 @@ will add tags "a", "b" and "c" to every item.
+ + + @@ -2899,6 +3676,9 @@ will add tags "a", "b" and "c" to every item.
+ + + @@ -2911,6 +3691,9 @@ will add tags "a", "b" and "c" to every item.
+ + + @@ -2923,6 +3706,9 @@ will add tags "a", "b" and "c" to every item.
+ + + @@ -3003,6 +3807,9 @@ returns 1 if an item has tag "a" or "b". + + + @@ -3015,6 +3822,9 @@ returns 1 if an item has tag "a" or "b". + + + @@ -3027,6 +3837,9 @@ returns 1 if an item has tag "a" or "b". + + + @@ -3039,6 +3852,9 @@ returns 1 if an item has tag "a" or "b". + + + @@ -3120,6 +3954,9 @@ returns every tag assigned to any item. + + + @@ -3132,6 +3969,9 @@ returns every tag assigned to any item. + + + @@ -3144,6 +3984,9 @@ returns every tag assigned to any item. + + + @@ -3156,6 +3999,9 @@ returns every tag assigned to any item. + + + + + + + + + @@ -3190,6 +4042,9 @@ returns every tag assigned to any item. + + + will remove tags "b" and "c" from any items that have them. @@ -3202,6 +4057,9 @@ will remove tags "b" and "c" from any items that have them. + + + @@ -3214,6 +4072,12 @@ will remove tags "b" and "c" from any items that have them. + + + + + + @@ -3237,6 +4101,9 @@ will remove tags "b" and "c" from any items that have them. + + +

Text Element

@@ -3249,6 +4116,9 @@ will remove tags "b" and "c" from any items that have them. + + + The new option -underline draws an underline under a single character of the displayed text.
@@ -3262,6 +4132,9 @@ draws an underline under a single character of the displayed text.
+ + +

Window Element

@@ -3274,6 +4147,9 @@ draws an underline under a single character of the displayed text.
+ + + 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 @@ -3291,6 +4167,9 @@ a window element, you would change this code:
+ + +

set canvas [canvas .t.canvas ...]
.t item element configure $item $column myElement -window $canvas

@@ -3303,6 +4182,9 @@ a window element, you would change this code:
+ + + to this:
@@ -3315,6 +4197,9 @@ to this:
+ + +

set frame [frame .t.clip -borderwidth 0]
set canvas [canvas $frame.canvas ...]
.t item element configure $item $column myElement -window $frame -clip yes

@@ -3327,6 +4212,9 @@ to this:
+ + + The -clip option tells the window element to manage the geometry of both the -window widget (i.e, @@ -3346,6 +4234,9 @@ demos. + + + New keywords were added to allow multiple items to be specified by an item description:
@@ -3358,6 +4249,9 @@ New keywords were added to allow multiple items to be specified by an The keyword list specifies a list of other item descriptions: @@ -3382,6 +4279,9 @@ specifies a list of other item descriptions: + + +

.t item id "list [list $a $b $c]"

@@ -3394,6 +4294,9 @@ specifies a list of other item descriptions: + + + @@ -3406,6 +4309,9 @@ specifies a list of other item descriptions: + + +

The keyword range operates like the item range command: @@ -3419,6 +4325,9 @@ range command: + + +

.t item id "range $first $last"

@@ -3431,6 +4340,9 @@ range command: + + +

@@ -3443,6 +4355,9 @@ range command: + + + @@ -3455,6 +4370,9 @@ range command: + + + New modifiers were added to match multiple items:

The modifier ancestors operates like the item ancestors command: @@ -3481,6 +4402,9 @@ ancestors command: + + +
```
.t item id "$item ancestors"
```
@@ -3493,6 +4417,9 @@ ancestors command: + + +
The modifier children operates like the item children command: @@ -3518,6 +4448,9 @@ children command: + + +
```
.t item id "$item children"
```
@@ -3530,6 +4463,9 @@ children command: + + +
The modifier descendants operates like the item descendants command: @@ -3555,6 +4494,9 @@ descendants command: + + +
```
.t item id "$item descendants"
```
@@ -3567,10 +4509,10 @@ descendants command: -

+ -New qualifiers were added to refine which items are matched:
@@ -3601,9 +4542,9 @@ New qualifiers were added to refine which items are matched:
+New qualifiers were added to refine which items are matched:
-

The qualifier depth -matches items at a given depth in the heirarchy:

@@ -3628,11 +4568,12 @@ matches items at a given depth in the heirarchy: -

The qualifier depth +matches items at a given depth in the heirarchy:

.t item id "all depth 2" ; # find all items that are children of the root's children
.t item id "depth 2" ; # ditto

@@ -3649,11 +4588,11 @@ matches items at a given depth in the heirarchy: +

- @@ -3664,8 +4603,41 @@ matches items at a given depth in the heirarchy: +

.t item id "all depth 2" ; # find all items that are children of the root's children
.t item id "depth 2" ; # ditto

+ + + + + + + + + + + + + + +

.t item id "first !visible" ; # find the first item that is not displayed

The qualifier state matches items that have certain states set (or not set if '!' is used): @@ -3725,6 +4706,9 @@ matches items that have certain states set (or not set if '!' is used): + + +
```
.t item id "first state {selected !open}" ; # find the first item that is selected and collapsed
```
@@ -3737,6 +4721,9 @@ matches items that have certain states set (or not set if '!' is used): + + +
The qualifier tag matches items that meet a tag expression: @@ -3761,6 +4751,9 @@ matches items that meet a tag expression: + + +
```
.t item id "$item children tag {a && !b}" ; # find children of $item that have tag "a" but not tag "b"
```
@@ -3773,6 +4766,9 @@ matches items that meet a tag expression: + + +

all

.t item id "all !visible state myState" ; # find every item that is not displayed with user-defined state "myState"

.t item id "!visible state myState" ; # same as the previous example

@@ -3862,6 +4876,9 @@ qualifiers. For example:
+ + +

Column Descriptions

Demo Changes

New demo "My Computer". Demonstrates disabled items used as headers.
New demo "Column Locking". Demonstrates columns that do not scroll horizontally.
The "Big List" and "Firefox Privacy" demos were changed to use the new -clip option of window elements.

Misc Changes

The tail column header will not be drawn if the tail column's -visible option is false. This can look nicer with some themes.
The -itembackground colors for a column are now extended below any items in the simplest (and most typical) case where the treectrl's -orient option is @@ -4104,6 +5172,9 @@ colors are not drawn below the items.
If -itembackground colors are specified for the tail column, then they are drawn.
Memory usage is improved, especially for text elements.

Bug Fixes

item create: Fixed bug where -nextsibling and -prevsibling @@ -4180,6 +5266,9 @@ options could specify an orphan item.
item delete: Stopped items possibly being double-deleted by nested calls through <Selection> and <ItemDelete> @@ -4195,6 +5284,9 @@ binding scripts.
item expand, item collapse, item toggle: Only operate on items which exist when the command is called, not any that might get created by <Expand> @@ -4211,6 +5303,9 @@ binding scripts.
Fixed a crash and a redisplay problem when a master element was configured with a -textvariable and the associated variable changed.
When a style with window elements spanned more than one column, the window might be improperly sized during display updates.
Windows in window elements would not always be unmapped if columns or items were hidden, or if the span of an item-column changed.
The disclosure triangles (i.e., the item buttons) are drawn without a white background under OSX.

What's New in TkTreeCtrl 2.1.1

Column Command

Arguments/Result Changed	What changed
item count	Takes an optional item-description argument; the result is the number of items that match the item description. For example: @@ -2409,6 +3063,12 @@ is the number of items that match the item description. For example: + + + + + + @@ -2431,6 +3091,9 @@ is the number of items that match the item description. For example: + + + will return the number of items that are displayed (i.e., those whose ancestors are all expanded, -visible options are true, etc), and: @@ -2444,6 +3107,12 @@ whose ancestors are all expanded, -visible options are true, etc), and: + + + + + + @@ -2466,6 +3135,9 @@ whose ancestors are all expanded, -visible options are true, etc), and: + + + will return the number of items with either tag "a" or "b", but not both.
item create	New option -tags specifies an initial list of tags for created items.
item id	Returns a list of item ids if the item description matches multiple items. For example: @@ -2577,6 +3273,12 @@ matches multiple items. For example: + + + + + + @@ -2599,6 +3301,9 @@ matches multiple items. For example: + + + will return a list of ids for all items, and: @@ -2611,6 +3316,12 @@ will return a list of ids for all items, and: + + + + + + @@ -2633,11 +3344,10 @@ will return a list of ids for all items, and: -will return the ids of every child of an item.
New	Comment	New
Comment
item descendants	Returns the ids of the children, grandchildren, etc of -an item.
item descendants
Returns the ids of the children, grandchildren, etc of +an item.
Gets and sets the enabled state for items. All items are enabled when first created. Disabled items cannot be selected, and are ignored by the default key-navigation @@ -2793,6 +3543,9 @@ and mouse bindings.
item tag add	Add tags to items. For example: @@ -2841,6 +3603,12 @@ and mouse bindings.
item tag expr	Evaluate a tag expression against items. For example: @@ -2935,6 +3721,12 @@ will add tags "a", "b" and "c" to every item. + + + + + + @@ -2957,6 +3749,9 @@ will add tags "a", "b" and "c" to every item. + + + returns 1 if an item has tag "a". Also: @@ -2969,6 +3764,12 @@ returns 1 if an item has tag "a". Also: + + + + + + @@ -2991,6 +3792,9 @@ returns 1 if an item has tag "a". Also: + + + returns 1 if an item has tag "a" or "b".
item tag names	Return a list of tag names assigned to items. For example: @@ -3052,6 +3868,12 @@ example: + + + + + + @@ -3074,6 +3896,9 @@ example: + + + returns the tag list for an item, and: @@ -3086,6 +3911,12 @@ returns the tag list for an item, and: + + + + + + @@ -3108,6 +3939,9 @@ returns the tag list for an item, and: + + + returns every tag assigned to any item.
item tag remove	Remove tags from items. For example: @@ -3168,6 +4014,12 @@ returns every tag assigned to any item.

@@ -4313,6 +5429,9 @@ without a white background under OSX. + + + @@ -4325,6 +5444,9 @@ without a white background under OSX. + + + @@ -4337,6 +5459,9 @@ without a white background under OSX. + + + @@ -4350,6 +5475,9 @@ Changed + + + @@ -4363,6 +5491,9 @@ changed + + + @@ -4375,6 +5506,9 @@ changed + + + @@ -4387,6 +5521,9 @@ changed + + + @@ -4411,6 +5551,9 @@ changed + + + @@ -4424,6 +5567,9 @@ columns to be deleted. + + + @@ -4436,6 +5582,12 @@ columns to be deleted. + + + + + + @@ -4459,6 +5611,9 @@ columns to be deleted. + + +

Bug Fixes

@@ -4471,6 +5626,9 @@ columns to be deleted. + + +

The item sort command will be much faster in many cases. There was a silly error in the @@ -4498,6 +5659,9 @@ pivot-finding code of quicksort which resulted in the slow-down.
A column header will be redisplayed if an image in the header is altered.
Fixed bus errors on some Unix systems due to alignment problems.

@@ -4536,6 +5706,9 @@ problems. + + +

Other Changes

@@ -4548,6 +5721,9 @@ problems. + + +

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.
Improved the appearance of the column headers under OSX.
Added <MouseWheel> support to OSX.
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 @@ -4615,10 +5803,10 @@ the next display update.

+ @@ -4627,19 +5815,18 @@ the next display update. -

Demo Changes

New demo "Column Spanning". Demonstrates a 100-column list +where styles span from 1 to 20 columns each.
New demo "Column Spanning". Demonstrates a 100-column list -where styles span from 1 to 20 columns each.
The screen-magnifier image now resizes with the "loupe" window.

What's New in TkTreeCtrl 2.1

TreeCtrl Configuration Options

Arguments/Result Changed	What changed
column delete @@ -4399,6 +5536,9 @@ changed + + +	Added an optional second argument allowing a range of columns to be deleted.

Column Configuration Options

@@ -5004,6 +6288,9 @@ obscure changes.
+ + +

New	Comment
-itemwidth	@@ -4849,6 +6094,9 @@ obscure changes. + + +
-itemwidthequal	Deprecates the column -widthhack option.
-itemwidthmultiple	Deprecates the column -stepwidth option.

@@ -5016,6 +6303,9 @@ obscure changes.
+ + + @@ -5028,6 +6318,9 @@ obscure changes.
+ + + @@ -5040,6 +6333,9 @@ obscure changes.
+ + + @@ -5052,6 +6348,9 @@ obscure changes.
+ + + @@ -5066,6 +6365,9 @@ instead + + + @@ -5078,6 +6380,9 @@ instead + + + @@ -5090,6 +6395,9 @@ instead + + + @@ -5102,6 +6410,9 @@ instead + + + @@ -5114,6 +6425,9 @@ instead + + + @@ -5126,6 +6440,9 @@ instead + + + @@ -5138,6 +6455,9 @@ instead + + + @@ -5150,6 +6470,9 @@ instead + + + @@ -5162,6 +6485,9 @@ instead + + + @@ -5174,6 +6500,12 @@ instead + + + + + + @@ -5197,6 +6529,9 @@ instead + + +

Element Command

@@ -5209,6 +6544,9 @@ instead + + +

Deprecated	What to use instead
-stepwidth	treectrl's -itemwidthmultiple option
-widthhack	treectrl's -itemwidthequal option

@@ -5221,6 +6559,9 @@ instead + + + @@ -5233,6 +6574,9 @@ instead + + + @@ -5245,6 +6589,9 @@ instead + + + @@ -5257,6 +6604,9 @@ instead + + + @@ -5269,6 +6619,9 @@ instead + + + @@ -5281,6 +6634,9 @@ instead + + + @@ -5293,6 +6649,9 @@ instead + + + @@ -5305,6 +6664,9 @@ instead + + + @@ -5317,6 +6679,9 @@ instead + + + @@ -5329,6 +6694,12 @@ instead + + + + + + @@ -5352,6 +6723,9 @@ instead + + +

Item Configuration Options

@@ -5364,6 +6738,9 @@ instead + + +

New	Comment
element perstate	Like [item element perstate].

@@ -5376,6 +6753,9 @@ instead + + + @@ -5388,6 +6768,9 @@ instead + + + @@ -5400,6 +6783,9 @@ instead + + + @@ -5412,6 +6798,9 @@ instead + + + @@ -5424,6 +6813,9 @@ instead + + + @@ -5436,6 +6828,9 @@ instead + + + @@ -5448,6 +6843,9 @@ instead + + + @@ -5460,6 +6858,9 @@ instead + + + @@ -5472,6 +6873,9 @@ instead + + + @@ -5484,6 +6888,12 @@ instead + + + + + + @@ -5507,10 +6917,10 @@ instead -

Item Command

@@ -5519,19 +6929,18 @@ instead -

New	Comment
-height	Overrides the treectrl's -itemheight option

Deprecated
What -to use -instead	Deprecated
What +to use +instead
item element actual	item element perstate
item element actual
item element perstate	item complex	item element configure
item complex	item element configure
What changed
item bbox	No longer returns an error if no style had been assigned to the column.
item state forcolumn	No longer returns an error if no style had been assigned to the column.
item style set	Does nothing when replacing a style with the same style. Previously the old style was freed before assigning the new style, @@ -5876,6 +7376,9 @@ losing the element config info if the old and new styles were the same. + + + Potential incompatibility
Arguments/Result Changed	What changed
item create	Added options: -count -height, -nextsibling, -open, -parent, -prevsibling, and -returnid. Multiple items may be created with one @@ -5990,6 +7517,9 @@ call using the -count option.
item element configure	Multiple elements in multiple columns may be configured with a single call. Use '+' to separate elements, and ',' to separate @@ -6041,6 +7580,9 @@ columns. See the docs.
item style set	When no column is specified, returns a list of one style name per column. Previously, the list would have less values than the number @@ -6093,8 +7644,1164 @@ column(s). - Potential -incompatibility
item text	When no column is specified, returns a list of one +string per column.
New	Comment
item image	Partner to the [item text] command.
item element perstate	Not really new, just renamed from [item element actual] +to +better describe what it does. Accepts a new optional argument which +specifies the state to use when determining the value of the per-state +option. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +The following options no longer return a default value if the per-state +option itself does not have a value specified: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + bitmap -foreground, -background + + + + + + + + + + + + + + + border -relief + + + + + + + + + + + + + + + text -fill, -font + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Potential +incompatibility
item span	A style may now be displayed over multiple adjacent +columns. + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + + +

Notify +Command

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

New	Comment
notify unbind + + + + + + + + + + + + + + +	Let's you unbind all scripts from an object with one +call.

+ + + + + + + + + + + + + + +

Style Layout Changes

+ + + + + + + + + + + + + + +

Column justification will now affect the position of +elements in 2 situations which previously had no effect (Potential incompatibility):

+ + + + + + + + + + + + + + +

If a -detach element had a fixed width larger than the +other elements.
If an element had -iexpand x specified as well as +-maxwidth, leaving some space available.

+ + + + + + + + + + + + + + +

Element Changes

+ + + + + + + + + + + + + + +

Bitmap, image and text elements are drawn clipped if given +less space than they need.
Fixed line wrapping of text elements. It did not work for +single lines of text at all (Potential +incompatibility).
The text -wrap option can now be none to disable line +wrapping.

+ + + + + + + + + + + + + + +

Event Changes

+ + + + + + + + + + + + + + +

The new static event <ItemVisibility> +is generated when items become visible on screen and when items are no +longer visible on screen. +This event allows you to create really big lists by only assigning +styles when items are about to be displayed. See the EVENTS AND SCRIPT +SUBSTITUTIONS section in the help +file, and the new demo "Big List".

+ + + + + + + + + + + + + + +

Other Changes

+ + + + + + + + + + + + + + +

On WinXP, the column header sort arrow is drawn like +Explorer draws it if -usetheme +is true.

+ + + + + + + + + + + + + + +

Demo Changes

+ + + + + + + + + + + + + + +

New demo "Big List". Demonstrates the new <ItemVisibility> +event, using <Expand-before> to add items on demand, and +column spanning.
The context menu has a Span +submenu that lets you manipulate column spanning in items. See +the item span +command in the help file.
Under WinXP, the "Explorer" demos will use the new shellicon +extension if available. This extension allows a treectrl to display +file/folder icons using the Win32 Shell API. It may work on other +versions of Windows but it hasn't been tested.

@@ -6118,19 +8825,19 @@ incompatibility - +

What's New in TkTreeCtrl 2.0

- item text @@ -6139,11 +8846,10 @@ incompatibility +

TreeCtrl Configuration Options

+ @@ -6350,10 +9040,10 @@ option itself does not have a value specified:
-

bitmap -foreground, -background

+ @@ -6362,19 +9052,18 @@ option itself does not have a value specified:
-

border -relief

+ -

text -fill, -font

@@ -6384,19 +9073,9 @@ option itself does not have a value specified:
+ - - - - - - - - - - - @@ -6408,9 +9087,8 @@ option itself does not have a value specified:
- Potential -incompatibility + @@ -6421,11 +9099,11 @@ incompatibility - + @@ -6433,7 +9111,6 @@ incompatibility - @@ -6441,11 +9118,11 @@ incompatibility + - @@ -6456,9 +9133,8 @@ incompatibility + - + @@ -6482,30 +9158,18 @@ columns.
- + - - - - - - - - - - - -

New
Comment	Replaced
What +to use +instead	item image
Partner to the [item text] command.
-openbuttonimage
item element perstate	-buttonimage	Not really new, just renamed from [item element actual] -to -better describe what it does. Accepts a new optional argument which -specifies the state to use when determining the value of the per-state -option. +
-closedbuttonimage	-buttonimage
-openbuttonbitmap
-buttonbitmap
item span
A style may now be displayed over multiple adjacent -columns. @@ -6470,9 +9146,9 @@ columns. -	-closedbuttonbitmap
-buttonbitmap

@@ -6514,11 +9178,10 @@ columns.
+ -

Notify -Command

@@ -6530,7 +9193,7 @@ Command - + @@ -6542,10 +9205,11 @@ Command - + @@ -6554,19 +9218,19 @@ Command - + - @@ -6576,9 +9240,9 @@ Command + - @@ -6590,8 +9254,8 @@ Command - + @@ -6602,11 +9266,11 @@ Command - + @@ -6614,7 +9278,6 @@ Command - - @@ -6637,9 +9305,8 @@ Command + - @@ -6651,9 +9318,9 @@ call. - + @@ -6663,30 +9330,18 @@ call. - - - - - - - - - - - -

Usage +Changed
How +it changed	New
Comment
-backgroundmode	notify unbind @@ -6622,11 +9285,16 @@ Command +	The values "index" and "visindex" are deprecated. The +value +"order" should be used instead of "index", and +"ordervisible" should be used instead of "visindex". This brings +agreement with the new "item order" command which replaces the "item +index" command.
Let's you unbind all scripts from an object with one -call.

+ -treecolumn -

Style Layout Changes

@@ -6695,10 +9350,14 @@ call. + This used to be any integer value which may or may not +have +corresponded to an actual column. Now the value must be a valid column +description, or an empty string to indicate no column should display +buttons/lines. -

Column justification will now affect the position of -elements in 2 situations which previously had no effect (Potential incompatibility):

+ New -

If a -detach element had a fixed width larger than the -other elements.

@@ -6758,10 +9414,9 @@ other elements. + -

If an element had -iexpand x specified as well as --maxwidth, leaving some space available.

@@ -6773,8 +9428,8 @@ other elements. - + @@ -6785,11 +9440,11 @@ other elements. -

Element Changes

+ @@ -6797,7 +9452,6 @@ other elements. -

Bitmap, image and text elements are drawn clipped if given -less space than they need.
Fixed line wrapping of text elements. It did not work for -single lines of text at all (Potential -incompatibility).
The text -wrap option can now be none to disable line -wrapping.

+ -

Event Changes

@@ -6870,10 +9519,10 @@ wrapping. + -columnprefix -

The new static event <ItemVisibility> -is generated when items become visible on screen and when items are no -longer visible on screen. -This event allows you to create really big lists by only assigning -styles when items are about to be displayed. See the EVENTS AND SCRIPT -SUBSTITUTIONS section in the help -file, and the new demo "Big List".

+ @@ -6915,19 +9558,18 @@ file, and the new demo "Big List". -

Other Changes

+ -

On WinXP, the column header sort arrow is drawn like -Explorer draws it if -usetheme -is true.

+ @@ -6965,11 +9605,11 @@ is true. -

Demo Changes

+ @@ -6977,7 +9617,6 @@ is true. -

New demo "Big List". Demonstrates the new <ItemVisibility> -event, using <Expand-before> to add items on demand, and -column spanning.
The context menu has a Span -submenu that lets you manipulate column spanning in items. See -the item span -command in the help file.
Under WinXP, the "Explorer" demos will use the new shellicon -extension if available. This extension allows a treectrl to display -file/folder icons using the Win32 Shell API. It may work on other -versions of Windows but it hasn't been tested.

+ -

What's New in TkTreeCtrl 2.0

@@ -7055,10 +9684,10 @@ versions of Windows but it hasn't been tested. + -

TreeCtrl Configuration Options

@@ -7070,7 +9699,7 @@ versions of Windows but it hasn't been tested. - + @@ -7082,10 +9711,10 @@ versions of Windows but it hasn't been tested. - + @@ -7094,19 +9723,18 @@ versions of Windows but it hasn't been tested. - + - @@ -7116,11 +9744,9 @@ versions of Windows but it hasn't been tested. + - @@ -7132,8 +9758,8 @@ instead - + @@ -7144,11 +9770,11 @@ instead - + @@ -7156,7 +9782,6 @@ instead - @@ -7164,11 +9789,11 @@ instead + - @@ -7179,8 +9804,22 @@ instead + + + + + + + + + + + + + + +

Replaced
-minitemheight

What -to use -instead
-usetheme
	-openbuttonimage
-buttonimage

- @@ -7192,9 +9831,9 @@ instead - +

TreeCtrl Commands

@@ -7204,19 +9843,18 @@ instead - -closedbuttonimage + - @@ -7225,10 +9863,10 @@ instead + - @@ -7252,19 +9890,14 @@ instead - - - - - + - @@ -7275,8 +9908,10 @@ instead + - @@ -7288,9 +9923,9 @@ instead - + @@ -7300,19 +9935,18 @@ instead - + - @@ -7321,10 +9955,10 @@ instead + - @@ -7336,7 +9970,7 @@ instead - + @@ -7348,11 +9982,10 @@ instead - + @@ -7361,20 +9994,18 @@ Changed - + - @@ -7384,9 +10015,9 @@ it changed + - @@ -7398,8 +10029,8 @@ it changed - + @@ -7410,16 +10041,11 @@ it changed - + @@ -7427,7 +10053,6 @@ index" command. - @@ -7435,11 +10060,11 @@ index" command. + - @@ -7450,8 +10075,8 @@ index" command. + - @@ -7463,13 +10088,9 @@ index" command. - + @@ -7479,19 +10100,18 @@ buttons/lines. - + - @@ -7500,10 +10120,10 @@ buttons/lines. + - @@ -7515,7 +10135,7 @@ buttons/lines. - + @@ -7527,10 +10147,10 @@ buttons/lines. - + @@ -7539,19 +10159,18 @@ buttons/lines. - + - @@ -7561,9 +10180,9 @@ buttons/lines. + - @@ -7575,8 +10194,8 @@ buttons/lines. - + @@ -7587,11 +10206,11 @@ buttons/lines. - + @@ -7599,7 +10218,6 @@ buttons/lines. - @@ -7607,11 +10225,11 @@ buttons/lines. + - @@ -7622,8 +10240,22 @@ buttons/lines. + + + + + + + + + + + + + + +

How -it changed
-buttonimage
-openbuttonbitmap	Deprecated	-buttonbitmap	What +to use +instead
-closedbuttonbitmap
-buttonbitmap	compare
item compare	Usage -Changed
index
-backgroundmode	item id	The values "index" and "visindex" are deprecated. The -value -"order" should be used instead of "index", and -"ordervisible" should be used instead of "visindex". This brings -agreement with the new "item order" command which replaces the "item -index" command.
numcolumns	-treecolumn	This used to be any integer value which may or may not -have -corresponded to an actual column. Now the value must be a valid column -description, or an empty string to indicate no column should display -buttons/lines.	column count
New		numitems
item count
-backgroundimage

range
item range	-columnprefix

- @@ -7635,9 +10267,9 @@ buttons/lines. - +

Column Configuration Options

@@ -7647,19 +10279,18 @@ buttons/lines. - -columnresizemode + - @@ -7668,10 +10299,10 @@ buttons/lines. + - @@ -7695,10 +10326,10 @@ buttons/lines. - + @@ -7707,19 +10338,20 @@ buttons/lines. - + - @@ -7729,9 +10361,9 @@ buttons/lines. + - @@ -7743,8 +10375,8 @@ buttons/lines. - + @@ -7755,11 +10387,11 @@ buttons/lines. - + - @@ -7775,11 +10406,11 @@ buttons/lines. + - @@ -7790,8 +10421,8 @@ buttons/lines. + - @@ -7803,9 +10434,9 @@ buttons/lines. - + @@ -7815,30 +10446,18 @@ buttons/lines. - + - - - - - - - - - - - -


-itemprefix	Removed	What +to use +instead
-minitemheight
	-relief @@ -7767,7 +10399,6 @@ buttons/lines.
-state	-usetheme

@@ -7847,10 +10466,10 @@ buttons/lines. + -sunken -

TreeCtrl Commands

@@ -7862,7 +10481,7 @@ buttons/lines. - + @@ -7874,10 +10493,10 @@ buttons/lines. - + @@ -7886,19 +10505,18 @@ buttons/lines. - + - @@ -7908,11 +10526,9 @@ buttons/lines. + @@ -7924,8 +10540,8 @@ instead - + @@ -7936,11 +10552,12 @@ instead - + @@ -7948,7 +10565,6 @@ instead - @@ -7956,11 +10572,11 @@ instead + - @@ -7971,8 +10587,8 @@ instead + - @@ -7984,9 +10600,9 @@ instead - + @@ -7996,19 +10612,18 @@ instead - + - @@ -8017,10 +10632,10 @@ instead + - @@ -8044,11 +10659,11 @@ instead - - + @@ -8056,7 +10671,6 @@ instead - @@ -8064,11 +10678,12 @@ instead + - @@ -8079,8 +10694,8 @@ instead + - @@ -8092,9 +10707,9 @@ instead - + @@ -8104,19 +10719,18 @@ instead - + - @@ -8125,10 +10739,12 @@ instead + - @@ -8140,7 +10756,7 @@ instead - + @@ -8152,10 +10768,10 @@ instead - + @@ -8164,30 +10780,18 @@ instead - + -

Deprecated	Renamed -	What -to use -instead
-state
New +name	compare
item compare
-arrowpad	index	-arrowpadx	item id
numcolumns	Usage +Changed	column count	How +it changed
numitems
item count	-background
This is now a per-state option. See COLUMNS in the help +file +for valid state names.
range
item range
New - - - - - - - - - - -

@@ -8197,9 +10801,9 @@ instead + -

Column Configuration Options

New -name

Removed	-arrowbitmap -	What -to use -instead
	-relief @@ -8306,10 +10906,10 @@ instead +
-state
-arrowimage
	-sunken
-state
-arrowpady	Renamed @@ -8413,11 +11011,11 @@ instead
-maxwidth	-arrowpad		-arrowpadx
Usage -Changed	-resize	How -it changed

-background
This is now a per-state option. See COLUMNS in the help -file -for valid state names.	-state
	New +

-textlines
	-arrowbitmap +

- @@ -8710,8 +11309,8 @@ for valid state names. - +

Column Command

What +changed
-arrowimage

Deprecated	-arrowpady	What +to use +instead
-maxwidth	column index		column id
-resize
	Arguments/Result +Changed
-state
column configure -
-textlines		A column description of "all" is allowed if at least +one +option-value pair is given. @@ -8998,10 +11598,10 @@ for valid state names.

+ -

Column Command

What -to use -instead
column create
The result is a unique identifier. Previously the +result was +an +index in the list of columns.	Deprecated
column delete	column index	A column description of "all" is allowed.	column id
Arguments/Result -Changed	New	What -changed	Comment
column configure +
column compare	A column description of "all" is allowed if at least -one -option-value pair is given. @@ -9264,10 +11844,10 @@ option-value pair is given. +
column create	column count	The result is a unique identifier. Previously the -result was -an -index in the list of columns.	replaces "numcolumns"
column delete
A column description of "all" is allowed.	column dragconfigure

New	Comment
column dragcget
	column compare
column id	column count	replaces "column index"	replaces "numcolumns"
column dragconfigure	column list
column dragcget
	column order

column id	replaces "column index"

@@ -9666,19 +12258,18 @@ index in the list of columns. - +

Item Command

- @@ -9687,10 +12278,10 @@ index in the list of columns. + - @@ -9702,7 +12293,7 @@ index in the list of columns. - + @@ -9714,10 +12305,10 @@ index in the list of columns. - + @@ -9726,19 +12317,18 @@ index in the list of columns. - + - @@ -9748,9 +12338,11 @@ index in the list of columns. + - @@ -9762,8 +12354,8 @@ index in the list of columns. - + @@ -9774,22 +12366,11 @@ index in the list of columns. - - - - - - - - - - - -

column list
Removed	column order	What +to use +instead

+ @@ -9797,7 +12378,6 @@ index in the list of columns. -

Item Command

@@ -9805,11 +12385,11 @@ index in the list of columns. + item index - @@ -9820,8 +12400,8 @@ index in the list of columns. + - @@ -9833,9 +12413,9 @@ index in the list of columns. - + @@ -9845,21 +12425,18 @@ index in the list of columns. - + - @@ -9868,10 +12445,10 @@ instead + - @@ -9883,7 +12460,7 @@ instead - + @@ -9895,10 +12472,10 @@ instead - + @@ -9907,19 +12484,18 @@ instead - + - @@ -9929,9 +12505,9 @@ instead + - @@ -9943,8 +12519,8 @@ instead - + @@ -9955,11 +12531,11 @@ instead - + @@ -9967,7 +12543,6 @@ instead - @@ -9975,11 +12550,11 @@ instead + - @@ -9990,8 +12565,8 @@ instead + - @@ -10003,9 +12578,9 @@ instead - + @@ -10015,19 +12590,18 @@ instead - + - @@ -10036,10 +12610,10 @@ instead + - @@ -10051,7 +12625,7 @@ instead - + @@ -10063,10 +12637,10 @@ instead - + @@ -10075,19 +12649,18 @@ instead - + - @@ -10097,9 +12670,9 @@ instead + - @@ -10111,8 +12684,8 @@ instead - + @@ -10123,11 +12696,11 @@ instead - + @@ -10135,7 +12708,6 @@ instead - @@ -10143,11 +12715,11 @@ instead + - @@ -10158,8 +12730,8 @@ instead + - @@ -10171,9 +12743,9 @@ instead - + @@ -10183,19 +12755,18 @@ instead - + - @@ -10204,10 +12775,10 @@ instead + - @@ -10229,6 +12800,9 @@ instead + + +

Removed
item order
What -to use -instead	New
Comment	item index
item order
item compare
New	replaces "compare"	Comment
item count	item compare	replaces "compare"	replaces "numitems"
item count	replaces "numitems"	item id
replaces "index"
item id
replaces "index"
item order
replaces "item index"	item order
replaces "item index"
item range	item range	replaces "range"	replaces "range"

@@ -10242,6 +12816,9 @@ instead + + +

Notify Command

Style Layout Options

@@ -10840,6 +13567,9 @@ above + + +

Arguments/Result Changed	What changed
notify generate @@ -10352,6 +12953,9 @@ changed + + +	Added optional percentsCommand argument
notify install	Old syntax (supported but deprecated): @@ -10425,6 +13044,12 @@ argument
notify linkage	Old syntax (supported but deprecated): @@ -10585,6 +13246,12 @@ New syntax: + + + + + + @@ -10606,6 +13273,9 @@ New syntax: + + + notify linkage eventName @@ -10618,6 +13288,12 @@ New syntax: + + + + + + @@ -10640,6 +13316,9 @@ New syntax: + + + @@ -10652,6 +13331,9 @@ New syntax: + + + New syntax: @@ -10664,6 +13346,12 @@ New syntax: + + + + + + @@ -10685,6 +13373,9 @@ New syntax: + + + notify linkage <eventName> @@ -10697,6 +13388,12 @@ New syntax: + + + + + + @@ -10719,6 +13416,9 @@ New syntax: + + + @@ -10731,6 +13431,9 @@ New syntax: + + +
notify uninstall	see notify install above

Element Changes

@@ -11513,6 +14408,9 @@ surrounds. + + +

A new element type window was added. See the new demo "Firefox Privacy" and the ELEMENTS section in the help @@ -11540,6 +14441,9 @@ file.
All element types have a new per-state boolean option called -draw.

-draw

text

-textvariable

@@ -11581,6 +14491,9 @@ See the new demo + + +

Event Changes

@@ -11593,6 +14506,9 @@ See the new demo + + +

2 new %-substitution characters %P and %? are allowed in binding @@ -11621,6 +14540,9 @@ file.
The new static event <ItemDelete> is generated when items are deleted. See the EVENTS AND SCRIPT SUBSTITUTIONS section in the help file.

@@ -11647,6 +14572,9 @@ SUBSTITUTIONS section in the help file. + + +

Library Script Changes

@@ -11659,6 +14587,9 @@ SUBSTITUTIONS section in the help file. + + +

filelist-bindings.tcl:

@@ -11671,6 +14602,9 @@ SUBSTITUTIONS section in the help file. + + +

The Priv(edit) variable, which is used to specify which text elements may be edited, now has the same format as Priv(sensitive). @@ -11698,6 +14635,9 @@ Previously only elements in the first column could be edited.
3 new commands in the TreeCtrl namespace should be used to access the Priv(dragimage), Priv(edit) and Priv(sensitive) variables. The @@ -11713,6 +14653,9 @@ commands are SetDragImage, SetEditable and SetSensitive.
Two new dynamic events <Edit-begin> and <Edit-end> are @@ -11728,6 +14671,9 @@ generated when editing a file name.

@@ -11740,6 +14686,9 @@ generated when editing a file name. + + +

treectrl.tcl:

@@ -11752,6 +14701,9 @@ generated when editing a file name. + + +

On OSX/Aqua, the Command key is used to perform discontinuous selection. Previously the Control key was used but Command is specified @@ -11779,6 +14734,9 @@ by Apple's user-interface guidelines.

@@ -11791,6 +14749,9 @@ by Apple's user-interface guidelines. + + +

Other Changes

@@ -11803,6 +14764,9 @@ by Apple's user-interface guidelines. + + +

On WinXP, the column headers and open/close buttons are drawn using the system theme if -usetheme @@ -11830,6 +14797,9 @@ is true. The sort arrow is drawn the old-fashioned way.
On OSX/Aqua, the column headers and open/close buttons are drawn @@ -11849,6 +14819,9 @@ options.
Columns can be moved by drag-and-drop. See column dragconfigure in the help file.
Columns can be specified in new ways. See the COLUMN DESCRIPTION section in the help file.
Added new section DYNAMIC EVENTS to the help file.
Added new section PER-STATE OPTIONS to the help file.
The new style layout option -indent allows elements to be displayed in the button/line area. See the style layout command in the help @@ -11916,6 +14901,9 @@ file and the new demo "Firefox Privacy".
The new item description end is equivalent to last.

last

If you have version 1.1 installed, replace the old pkgIndex.tcl file with the one from this @@ -11947,6 +14938,9 @@ scripts are found.

@@ -11959,6 +14953,9 @@ scripts are found. + + +

Demo Changes

@@ -11971,6 +14968,9 @@ scripts are found. + + +

New demo "Firefox Privacy". Demonstrates the new window element type and -indent style layout option.
New demo "Textvariable". Demonstrates the new -textvariable option of the text element.
Added a new Event Browser window to display events generated by the main treectrl widget.
The context menu can be popped up in all the demo lists. A <Control-ButtonPress-1> binding for this was added under OSX/Aqua.
In the "Explorer" demos, the file name is hidden while editing the file name.

@@ -12065,5 +15083,8 @@ the file name. + + + -- cgit v0.12

Usage Changed	How it changed
-iexpand	Two new flags "x' and "y" are allowed. Previously, only the -ipadx and -ipady padding could be expanded by this option. The new xy @@ -10954,6 +13708,12 @@ update your code, you will probably want to change this: + + + + + + @@ -10975,6 +13735,9 @@ update your code, you will probably want to change this: + + + $T style layout $S $E -iexpand we @@ -10987,6 +13750,9 @@ update your code, you will probably want to change this: + + + @@ -10999,6 +13765,9 @@ update your code, you will probably want to change this: + + + to this: @@ -11011,6 +13780,12 @@ to this: + + + + + + @@ -11032,6 +13807,9 @@ to this: + + + $T style layout $S $E -iexpand x @@ -11044,6 +13822,9 @@ to this: + + + @@ -11056,6 +13837,9 @@ to this: + + + 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.
New @@ -11106,6 +13899,9 @@ surrounds. + + +
-height
-maxheight
-maxwidth
-minheight
-minwidth
-sticky
-width