From 83be72176d8d2702f1fd4adf62171a5e3811da13 Mon Sep 17 00:00:00 2001 From: treectrl Date: Mon, 22 Jan 2007 22:43:58 +0000 Subject: Update version to 2.2.2. --- configure | 2 +- configure.ac | 4 +- demos/demo.tcl | 4 +- doc/What's New in TkTreeCtrl.html | 8002 ++++++++++++++++++++++++++++++------- doc/treectrl.html | 22 +- doc/treectrl.man | 20 +- doc/treectrl.n | 17 +- shellicon/pkgIndex.tcl | 2 +- 8 files changed, 6555 insertions(+), 1518 deletions(-) diff --git a/configure b/configure index da634a4..1b166b3 100644 --- a/configure +++ b/configure @@ -1772,7 +1772,7 @@ ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $ ac_compiler_gnu=$ac_cv_c_compiler_gnu -PACKAGE_PATCHLEVEL=2.2 +PACKAGE_PATCHLEVEL=2.2.2 cat >>confdefs.h <<_ACEOF #define PACKAGE_PATCHLEVEL "$PACKAGE_PATCHLEVEL" diff --git a/configure.ac b/configure.ac index b711c13..3576041 100644 --- a/configure.ac +++ b/configure.ac @@ -3,7 +3,7 @@ dnl This file is an input file used by the GNU "autoconf" program to dnl generate the file "configure", which is run during Tcl installation dnl to configure the system for the local environment. # -# RCS: @(#) $Id: configure.ac,v 1.19 2006/11/21 19:27:31 treectrl Exp $ +# RCS: @(#) $Id: configure.ac,v 1.20 2007/01/22 22:43:58 treectrl Exp $ #----------------------------------------------------------------------- # Sample configure.in for Tcl Extensions. @@ -20,7 +20,7 @@ dnl to configure the system for the local environment. #----------------------------------------------------------------------- AC_INIT([treectrl], [2.2]) -AC_SUBST([PACKAGE_PATCHLEVEL], [2.2]) +AC_SUBST([PACKAGE_PATCHLEVEL], [2.2.2]) AC_DEFINE_UNQUOTED(PACKAGE_PATCHLEVEL, "$PACKAGE_PATCHLEVEL") TEA_INIT([3.5]) diff --git a/demos/demo.tcl b/demos/demo.tcl index 7bbf9b8..3bf1f25 100644 --- a/demos/demo.tcl +++ b/demos/demo.tcl @@ -1,8 +1,8 @@ #!/bin/wish84.exe -# RCS: @(#) $Id: demo.tcl,v 1.62 2007/01/21 22:57:24 treectrl Exp $ +# RCS: @(#) $Id: demo.tcl,v 1.63 2007/01/22 22:44:26 treectrl Exp $ -set VERSION 2.2 +set VERSION 2.2.2 package require Tk 8.4 diff --git a/doc/What's New in TkTreeCtrl.html b/doc/What's New in TkTreeCtrl.html index c168628..2df1413 100644 --- a/doc/What's New in TkTreeCtrl.html +++ b/doc/What's New in TkTreeCtrl.html @@ -1,13 +1,23 @@ - + + + + + + + + + + + @@ -19,6 +29,11 @@ + + + + + @@ -31,6 +46,16 @@ + + + + + + + + + + What's New in TkTreeCtrl @@ -43,286 +68,247 @@ -

What's New in TkTreeCtrl 2.2.x

Column Configuration Options

What's New in TkTreeCtrl 2.2.2

- - - +

Column Configuration Options

- - - +

New	Comment

- - + - - - - - - -

-itemjustify

This option allows item styles to to 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 -according to the -justify option of the column.

+ -

Item Configuration Options

- + - - + - - + - - + - - + - - - - - - -

New
Comment	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.	-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 +according to the -justify option of the column. -

Style Layout Changes

The element option -draw of every element type is now deprecated. Use the new style layout option -draw instead.
The new per-state 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 -the layout.
If none of the elements surrounded by an element with -union layout are visible, then the element with -union layout is not displayed.

+ + + + + + + + + + -

Item Descriptions

Item Configuration Options

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

+ -

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

Bug Fixes

+ -

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.

- -

What's New in TkTreeCtrl 2.2

+ -

TreeCtrl Configuration Options

+ -

Usage +Changed

- + - + - - + - + - - + - + - @@ -334,6 +320,10 @@ instead + + + +

How +it changed
Deprecated	What -to use -instead
-button
-defaultstyle	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.	The -itemstyle option of a column.

@@ -342,553 +332,502 @@ instead -

TreeCtrl Command

Style Layout Changes

- - +

- +

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 +the layout and is not displayed. If none of the elements surrounded by an element with -union layout are visible, then the element with -union layout is not displayed.

- + - - +

Item Descriptions

- +

- - +

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

- + - - +

Bug Fixes

- +

- - +

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.

- - + - +

What's New in TkTreeCtrl 2.2.1

- +

Bug Fixes

- +

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.
selection get	Accepts 2 optional arguments to allow in-place lindex and lrange queries of -the selection. For example: + + .t item id "root child end-1" ; # get the second-to-last child of the root item - - - - - - .t selection get 0 ; # the first selected item .t selection get end ; # the last selected item .t selection get 1 end-1 ; # every selected item except the first and last + -
New	Comment
bbox	Returns the bounding box of different areas of the -window. For example: + - - - - - - .t bbox + 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. -will return the bounds of the window, and: + Fixed a crash when invalidating a column of an item if the column wasn't the first in a span. - - - - - - .t bbox header + Fixed a leak on X11 where the clipping region was not being freed after drawing dotted rectangles. + -will return the bounds of the column headers, and: + + What's New in TkTreeCtrl 2.2 - - - - - - .t bbox content -will return the same result as the [contentbox] command, and: + TreeCtrl Configuration Options - - - - - - .t bbox left .t bbox right -will return the bounds of the left-locked and right-locked columns.

- - - - - - - -

+ -

Column Configuration Options

- + - + - - - - + - - + - - - + - - + - - + - + + + + + + + + + + + +

Deprecated
Renamed +	What +to use +instead	New -name
-tag	-tags	-defaultstyle
The -itemstyle option of a column.	New	Comment

- - -lock +

TreeCtrl Command

- This option allows columns to stick to the left or -right edge -of the window. Locked columns can scroll vertically but not -horizontally. Valid values for this option are none (the default), left or right. - + - - + - - + - - + - - - - - - -

.t column configure 0 -uniform a
.t column configure 1 -uniform a

-will give columns 0 and 1 the same requested width, whichever is the -larger of the two columns. And:
+ - - - - - -

.t column configure 0 -uniform a -weight 2
.t column configure 1 -uniform a

-will give column 0 twice the maximum of the requested widths of columns -0 and 1. And:
+ - - - - - -

.t column configure 0 -expand yes -weight 2
.t column configure 1 -expand yes

-will give column 0 twice the extra space as column 1. + - - + - @@ -902,383 +841,380 @@ will give column 0 twice the extra space as column 1. - - - - - - -

-itemstyle
Specifies the name of a style to set in this column for -newly-created items. This option replaces the treectrl option --defaultstyle.
-uniform	Arguments/Result +Changed	These two options -operate the same as the grid geometry manager options of the same name. -For example: +	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.	-weight

+ -

Column Command

- + - - + - + + + + + + + + + + +

.t selection get 0       ; # the first selected item
.t selection get end     ; # the last selected item
.t selection get 1 end-1 ; # every selected item except the first and last

- - + - - - - - - - -

.t column count visible

+ -will return the number of columns whose -visible option is true, and:
- - - - - -

.t column count {tag a^b}

+ -will return the number of columns with either tag "a" or "b", but not -both. - + - - + - - + - - + - + - + + + + + + + + + + +

.t bbox

- - +will return the bounds of the window, and:
- - + + + + + + + + + + +

.t bbox header

- - +will return the bounds of the column headers, and:
- - + + + + + + + + + + +

.t bbox content

- - - - - - -

New
selection get
Accepts 2 optional arguments to allow in-place lindex and lrange queries of +the selection. For example: -	Arguments/Result -Changed	What -changed
column count	Takes an optional column-description argument; the -result is -the number of columns that match the column description. For example: +
Comment
New
Comment
column tag add	bbox	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 -word "tail" in column descriptions.	Returns the bounding box of different areas of the +window. For example: -
column tag expr
column tag names
column tag remove

+will return the same result as the [contentbox] command, and:
-

Item Configuration Options

- + + + + + + + + + + +

.t bbox left
.t bbox right

- - +will return the bounds of the left-locked and right-locked columns. - - + - - + + + + + + + + + + + +

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 -item descriptions to operate on multiple items. More information can be -found in the man page. +

Column Configuration Options

- + - - - - - - -

Item Command

- - - - + - @@ -1292,114 +1228,90 @@ found in the man page. - - - - + - + - + - -will return the number of items that are displayed (i.e., those -whose ancestors are all expanded, -visible options are true, etc), and:
- - - - - -

.t item count {tag a^b}

+ -will return the number of items with either tag "a" or "b", but not -both. - + - - + - @@ -1413,60 +1325,41 @@ specifies an initial list of tags for created items. - - - - - - + - -will return a list of ids for all items, and:
- - - - - -

.t item id "$item children"

+ -will return the ids of every child of an item. @@ -1480,50 +1373,44 @@ will return the ids of every child of an item. - - - - - - + - - + - - + - @@ -1537,106 +1424,93 @@ an item. - - - - + - - + - + - - - - - - - -

.t item tag add all {a b c}

-will add tags "a", "b" and "c" to every item.
+ - - + - - + - + + + + + + + + + + +

.t column configure 0 -uniform a -weight 2
.t column configure 1 -uniform a

- - +will give column 0 twice the maximum of the requested widths of columns +0 and 1. And:
- - - - - - -

.t item tag names all

-returns every tag assigned to any item. + - - + - - - - - - - -

.t item tag remove all {b c}

-will remove tags "b" and "c" from any items that have them. + - @@ -1807,6 +1674,11 @@ will remove tags "b" and "c" from any items that have them. + + + + +

Arguments/Result -Changed	What -changed	Renamed -
item count	New +name	Takes an optional item-description argument; the result -is the number of items that match the item description. For example: - - - - - - .t item count visible +
-tag
item create	-tags	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: - - - - - - .t item id all +	New	Comment
New
Comment
-lock
item descendants	This option allows columns to stick to the left or +right edge +of the window. Locked columns can scroll vertically but not +horizontally. Valid values for this option are none (the default), left or right.	Returns the ids of the children, grandchildren, etc of -an item.
item enabled
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 -and mouse bindings.
-itemstyle
Specifies the name of a style to set in this column for +newly-created items. This option replaces the treectrl option +-defaultstyle.	item tag add	Add tags to items. For example: +
-uniform
item tag expr	These two options +operate the same as the grid geometry manager options of the same name. +For example: -	Evaluate a tag expression against items. For example: @@ -1648,62 +1522,65 @@ will add tags "a", "b" and "c" to every item. - .t item tag expr $item a - - - - + + + + + + .t column configure 0 -uniform a .t column configure 1 -uniform a -returns 1 if an item has tag "a". Also: - - - - - - .t item tag expr $item a\|\|b +will give columns 0 and 1 the same requested width, whichever is the +larger of the two columns. And: -returns 1 if an item has tag "a" or "b".
item tag names		Return a list of tag names assigned to items. For -example: @@ -1715,87 +1592,77 @@ example: - .t item tag names $item + + + + + + .t column configure 0 -expand yes -weight 2 .t column configure 1 -expand yes -returns the tag list for an item, and: +will give column 0 twice the extra space as column 1.
item tag remove	Remove tags from items. For example: +	-weight

@@ -1815,141 +1687,1781 @@ will remove tags "b" and "c" from any items that have them. -

Text Element

Column Command

-The new option -underline -draws an underline under a single character of the displayed text.
-

Window Element

+ -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 -to display a child of a borderless frame widget, and setting the new -clip option of the -window element to TRUE. So if your program displays a canvas widget in -a window element, you would change this code:
-

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

+ -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

+ -The -clip -option tells the window element to manage the geometry of both the -window -widget (i.e, -the frame) and its first child widget (i.e., the canvas). In this case, -the frame widget is kept sized and positioned so that it is never -out-of-bounds. You can see this in the "Big List" and "Firefox Privacy" -demos. -

Item Descriptions

-New keywords were added to allow multiple items to be specified by an item description:
+ -

The keyword list -specifies a list of other item descriptions: - - - - - -
```
.t item id "list [list $a $b $c]"
```
+

- + -

The keyword range -operates like the item -range command: - - - - - -

.t item id "range $first $last"

+ - -New modifiers were added to match multiple items: -

Arguments/Result +Changed	What +changed
column count	Takes an optional column-description argument; the +result is +the number of columns that match the column description. For example: + + + + + + + + + + + + + + + + + + + + + + .t column count visible + + + + + + + + + + + +will return the number of columns whose -visible option is true, and: + + + + + + + + + + + + + + + + + + + + + + .t column count {tag a^b} + + + + + + + + + + + +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 +word "tail" in column descriptions.
column tag expr
column tag names
column tag remove

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

Item Configuration Options

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

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 +item descriptions to operate on multiple items. More information can be +found in the man page.

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

Item 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: + + + + + + + + + + + + + + + + + + + + + + .t item count visible + + + + + + + + + + + +will return the number of items that are displayed (i.e., those +whose ancestors are all expanded, -visible options are true, etc), and: + + + + + + + + + + + + + + + + + + + + + + .t item count {tag a^b} + + + + + + + + + + + +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: + + + + + + + + + + + + + + + + + + + + + + .t item id all + + + + + + + + + + + +will return a list of ids for all items, and: + + + + + + + + + + + + + + + + + + + + + + .t item id "$item children" + + + + + + + + + + + +will return the ids of every child of an item.
New	Comment
item descendants	Returns the ids of the children, grandchildren, etc of +an item.
item enabled	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 +and mouse bindings.
item tag add	Add tags to items. For example: + + + + + + + + + + + + + + + + + + + + + + .t item tag add all {a b c} + + + + + + + + + + + +will add tags "a", "b" and "c" to every item. + + + + + + + + + + + +
item tag expr	Evaluate a tag expression against items. For example: + + + + + + + + + + + + + + + + + + + + + + .t item tag expr $item a + + + + + + + + + + + +returns 1 if an item has tag "a". Also: + + + + + + + + + + + + + + + + + + + + + + .t item tag expr $item a\|\|b + + + + + + + + + + + +returns 1 if an item has tag "a" or "b".
item tag names	Return a list of tag names assigned to items. For +example: + + + + + + + + + + + + + + + + + + + + + + .t item tag names $item + + + + + + + + + + + +returns the tag list for an item, and: + + + + + + + + + + + + + + + + + + + + + + .t item tag names all + + + + + + + + + + + +returns every tag assigned to any item.
item tag remove	Remove tags from items. For example: + + + + + + + + + + + + + + + + + + + + + + .t item tag remove all {b c} + + + + + + + + + + + +will remove tags "b" and "c" from any items that have them.

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

Text Element

+ + + + + + + + + + + +The new option -underline +draws an underline under a single character of the displayed text.
+ + + + + + + + + + + +

Window Element

+ + + + + + + + + + + +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 +to display a child of a borderless frame widget, and setting the new -clip option of the +window element to TRUE. So if your program displays a canvas widget in +a window element, you would change this code:
+ + + + + + + + + + + +

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

+ + + + + + + + + + + +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

+ + + + + + + + + + + +The -clip +option tells the window element to manage the geometry of both the -window +widget (i.e, +the frame) and its first child widget (i.e., the canvas). In this case, +the frame widget is kept sized and positioned so that it is never +out-of-bounds. You can see this in the "Big List" and "Firefox Privacy" +demos. +

Item Descriptions

+ + + + + + + + + + + +New keywords were added to allow multiple items to be specified by an item description:
+ + + + + + + + + + + +

The keyword list +specifies a list of other item descriptions: + + + + + + + + + + +
```
.t item id "list [list $a $b $c]"
```
+ + + + + + + + + + + +
The keyword range +operates like the item +range command: + + + + + + + + + + +
```
.t item id "range $first $last"
```
+ + + + + + + + + + + +

+ + + + + + + + + + + +New modifiers were added to match multiple items: +

.t item id "$item ancestors"

.t item id "$item ancestors"

The modifier children +operates like the item +children command: + + + + + + + + + + +
```
.t item id "$item children"
```
+ + + + + + + + + + + +
The modifier descendants +operates like the item +descendants command: + + + + + + + + + + +
```
.t item id "$item descendants"
```
+ + + + + + + + + + + +

+ + + + + + + + + + + +New qualifiers were added to refine which items are matched:
+ + + + + + + + + + + +

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

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

The qualifier !visible +matches items that are not displayed: + + + + + + + + + + +
```
.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): + + + + + + + + + + +
```
.t item id "first state {selected !open}" ; # find the first item that is selected and collapsed
```
+ + + + + + + + + + + +
The qualifier tag +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"
```
+ + + + + + + + + + + +

+ + + + + + + + + + + +
+ + + + + + + + + + + +The keyword all +may now be followed by a list of qualifiers. For example:
+ + + + + + + + + + + +

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

+ + + + + + + + + + + +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:
+ + + + + + + + + + + +

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

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

Column Descriptions

+ + + + + + + + + + + +New keywords list +and +range can be used to +match multiple columns.
+ + + + + + + + + + + +New qualifiers state, +tag, !tail and !visible can be used +to restrict which columns are specified.
+ + + + + + + + + + + +The keyword all +may be followed by a list of qualifiers.
+ + + + + + + + + + + +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. +

Multi-item and multi-column commands

+ + + + + + + + + + + +Many commands can now operate on multiple items and/or columns by using +the improved item descriptions and column descriptions mentioned above. +For example: +

.t column configure "range 1 10" -tags {a b c}
.t column delete "tag a"
.t column id "tag {a || b}"
.t item configure "depth 1" -button yes
.t item count visible
.t item element configure "root children" all elem1 -text "Hello"
.t item id "visible"
.t item image all all image1
.t item style map "tag {a && !b}" "tag c" style2 {style1.elem1 style2.elem2}
.t item style set all all style1
.t item state forcolumn all all state1
.t item state set "tag current" ~mouseover
.t item remove "state selected"
.t item span "range 1 10" "range 10 last" 2
.t item text "root children" all "Hello"

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

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 +vertical and -wrap +option is unspecified. The height of the rows is determined by the -itemheight or -minitemheight +options; if neither of those options is specified, then -itembackground +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 +options could specify an orphan item.
item delete: +Stopped items possibly being double-deleted by nested calls through <Selection> +and <ItemDelete> +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> +or <Collapse> +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
column delete + + + + + + + + + + + +	Added an optional second argument allowing a range of +columns to be deleted.

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

Bug Fixes

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

The item sort +command +will be much faster in many cases. There was a silly error in the +pivot-finding code of quicksort which resulted in the slow-down.
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.

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

Other Changes

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

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 +of the selection. A change was made so that changes to the selection +caused by modifying the -visible option of an item do not occur until +the next display update.

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

Demo Changes

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

New demo "Column Spanning". Demonstrates a 100-column list +where styles span from 1 to 20 columns each.
The loupe +command (which performs screen capture to an image) is now implemented +on Windows and OSX thanks to Jeff Hobbs.
The screen-magnifier image now resizes with the "loupe" +window.

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

What's New in TkTreeCtrl 2.1

+ + + + + + + + + + + +This version should be backwards compatible with 2.0, except for a few +obscure changes.
+ + + + + + + + + + + +

TreeCtrl Configuration Options

New	Comment
-itemwidth	+ + + + + + + + + + + +
-itemwidthequal	Deprecates the column -widthhack option.
-itemwidthmultiple	Deprecates the column -stepwidth option.

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

Column Configuration Options

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

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

Element Command

New	Comment
element perstate	Like [item element perstate].

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

Item Configuration Options

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

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

Item Command

Deprecated	What +to use +instead
item element actual	item element perstate
item complex	item element configure
Behaviour +Changed	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, +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 +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 +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 +of columns if no styles had ever been assigned to the rightmost +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.

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

What's New in TkTreeCtrl 2.0

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

TreeCtrl Configuration Options

The modifier children -operates like the item -children command: - - - - - -

.t item id "$item children"

+ -

The modifier descendants -operates like the item -descendants command: - - - - - -

.t item id "$item descendants"

+ - -New qualifiers were added to refine which items are matched:
+ -

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

- + -

The qualifier !visible -matches items that are not displayed: - - - - - -
```
.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): - - - - - -

.t item id "first state {selected !open}" ; # find the first item that is selected and collapsed

- -

The qualifier tag -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"

- - + -
-The keyword all -may now be followed by a list of qualifiers. For example:
+ -

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

+ -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:
-

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

- -

Column Descriptions

+ -New keywords list -and -range can be used to -match multiple columns.
-New qualifiers state, -tag, !tail and !visible can be used -to restrict which columns are specified.
+ -The keyword all -may be followed by a list of qualifiers.
-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. -

Multi-item and multi-column commands

+ -Many commands can now operate on multiple items and/or columns by using -the improved item descriptions and column descriptions mentioned above. -For example: -

.t column configure "range 1 10" -tags {a b c}
.t column delete "tag a"
.t column id "tag {a || b}"
.t item configure "depth 1" -button yes
.t item count visible
.t item element configure "root children" all elem1 -text "Hello"
.t item id "visible"
.t item image all all image1
.t item style map "tag {a && !b}" "tag c" style2 {style1.elem1 style2.elem2}
.t item style set all all style1
.t item state forcolumn all all state1
.t item state set "tag current" ~mouseover
.t item remove "state selected"
.t item span "range 1 10" "range 10 last" 2
.t item text "root children" all "Hello"

+ -

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 -vertical and -wrap -option is unspecified. The height of the rows is determined by the -itemheight or -minitemheight -options; if neither of those options is specified, then -itembackground -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 -options could specify an orphan item.

item delete: -Stopped items possibly being double-deleted by nested calls through <Selection> -and <ItemDelete> -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> -or <Collapse> -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

+ + -

Replaced	What +to use +instead
-openbuttonimage	-buttonimage
-closedbuttonimage	-buttonimage
-openbuttonbitmap	-buttonbitmap
-closedbuttonbitmap	-buttonbitmap
Usage +Changed	How +it changed
-backgroundmode	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.
-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.
New
-backgroundimage
-columnprefix

- + + + + + + + @@ -2485,244 +7642,220 @@ without a white background under OSX. - + - - + - - - - + - - - - - - - -

Arguments/Result -Changed	-columnresizemode	What -changed

column delete +
Added an optional second argument allowing a range of -columns to be deleted.

+ -itemprefix -

Bug Fixes

The item sort -command -will be much faster in many cases. There was a silly error in the -pivot-finding code of quicksort which resulted in the slow-down.
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.

Other Changes

+ -minitemheight -

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 -of the selection. A change was made so that changes to the selection -caused by modifying the -visible option of an item do not occur until -the next display update.

Demo Changes

+ -usetheme -

New demo "Column Spanning". Demonstrates a 100-column list -where styles span from 1 to 20 columns each.
The loupe -command (which performs screen capture to an image) is now implemented -on Windows and OSX thanks to Jeff Hobbs.
The screen-magnifier image now resizes with the "loupe" -window.

+ + + + + + + + + + + + -

What's New in TkTreeCtrl 2.1

-This version should be backwards compatible with 2.0, except for a few -obscure changes.
+

TreeCtrl Commands

+ -

TreeCtrl Configuration Options

@@ -2736,70 +7869,67 @@ obscure changes.
- + - - New + - Comment - + Deprecated - - -itemwidth + What +to use +instead -
- + - @@ -2813,252 +7943,221 @@ obscure changes.
- -itemwidthequal - - Deprecates the column -widthhack option. + compare - + item compare - - -itemwidthmultiple + - Deprecates the column -stepwidth option. - + - - - - - - - -

Column Configuration Options

+ index - - + - - + - + - - + - - + - - + - - + - - - - - - - -

Deprecated
item id
What -to use -instead
numcolumns	-stepwidth	treectrl's -itemwidthmultiple option	column count
-widthhack	treectrl's -itemwidthequal option

+ numitems -

Element Command

+ item count - - + - - + - - + - - + - @@ -3072,6 +8171,16 @@ instead + + + + + + + + + + @@ -3085,169 +8194,151 @@ instead -

Item Configuration Options

- -

New
Comment
range
element perstate	item range	Like [item element perstate].

Column Configuration Options

- +

- - + - - + - - + - - + - - - - - - -

New
Comment
-height	Removed	Overrides the treectrl's -itemheight option
What +to use +instead

Item Command

+ - + - - + - + - - + - - + - @@ -3261,280 +8352,250 @@ instead - + - - + - - + - - + - - + - + - + - - + - - + - - - Potential -incompatibility - + - - + - + - - + - - + - - + - - + - - + + + - + - + + - @@ -3548,249 +8609,209 @@ incompatibility - + - + - - + - - + - - + - - + + - - -
-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 + - + - - + - + - - - - - - - -

Behaviour -Changed
-relief -	Deprecated	What -to use -instead
-state	item element actual	item element perstate
item complex	-sunken	item element configure
-state
What -changed
item bbox	Renamed -	No longer returns an error if no style had been -assigned to the column.
New +name	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, -losing the element config info if the old and new styles were the same. +	-arrowpad
-arrowpadx
Arguments/Result -Changed
What -changed
Usage +Changed	item create	Added options: -count -height, -nextsibling, -open, --parent, --prevsibling, and -returnid. Multiple items may be created with one -call using the -count option.	How +it changed
item element configure	Multiple elements in multiple columns may be configured -with -a single call. Use '+' to separate elements, and ',' to separate -columns. See the docs.
-background	item style set	This is now a per-state option. See COLUMNS in the help +file +for valid state names.	When no column is specified, returns a list of one -style name -per column. Previously, the list would have less values than the number -of columns if no styles had ever been assigned to the rightmost -column(s). - Potential -incompatibility
item text	New -	When no column is specified, returns a list of one -string per column.
New		Comment
item image
Partner to the [item text] command.
-arrowbitmap -
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. +
-arrowimage
item span
A style may now be displayed over multiple adjacent -columns. -	-arrowpady

+ -

Notify -Command

- + - @@ -3804,369 +8825,330 @@ Command - + - - + - - - - + - - - - - - - -

New	-maxwidth	Comment

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

+ -resize -

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.

+ -textlines -

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.

Column Command

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.

What's New in TkTreeCtrl 2.0

TreeCtrl Configuration Options

Deprecated

What +to use +instead
Replaced	What -to use -instead
column index
-openbuttonimage	column id	-buttonimage
-closedbuttonimage	-buttonimage	Arguments/Result +Changed
What +changed	-openbuttonbitmap	-buttonbitmap
-closedbuttonbitmap	column configure -	-buttonbitmap
Usage -Changed	A column description of "all" is allowed if at least +one +option-value pair is given. -	How -it changed
-backgroundmode
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.
column create	-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.	The result is a unique identifier. Previously the +result was +an +index in the list of columns.
New

column delete
-backgroundimage	A column description of "all" is allowed.
-columnprefix		New
Comment	-columnresizemode
-itemprefix		column compare

-minitemheight

-usetheme	column count
replaces "numcolumns"

TreeCtrl Commands

column dragconfigure	Deprecated	What -to use -instead
compare	item compare
column dragcget	index		item id
numcolumns
column count
column id
numitems	replaces "column index"	item count
range	item range	column list

Column Configuration Options

Removed	column order	What -to use -instead

-relief +
-state

Item Command

Renamed +
New -name	Removed
What +to use +instead	-arrowpad	-arrowpadx
Usage -Changed	item index	How -it changed
item order
-background
This is now a per-state option. See COLUMNS in the help -file -for valid state names.
New +	New		Comment
-arrowbitmap +
	item compare
replaces "compare"	-arrowimage
-arrowpady	item count
replaces "numitems"
-maxwidth

-resize	item id
replaces "index"
-state
item order	-textlines		replaces "item index"

Column Command

item range
Deprecated	replaces "range"	What -to use -instead

Notify Command

notify install event eventName

notify install detail eventName detail

notify install <eventName>

notify install <eventName-detail>

+ + + + + + + + + + +

notify linkage eventName

notify linkage eventName detail

Arguments/Result -Changed	What -changed
column configure +	Arguments/Result +Changed	A column description of "all" is allowed if at least -one -option-value pair is given. +	What +changed
column create
The result is a unique identifier. Previously the -result was -an -index in the list of columns.
notify generate -
column delete	A column description of "all" is allowed.	Added optional percentsCommand +argument
New	Comment
notify install	column compare		Old syntax (supported but deprecated): -
column count	replaces "numcolumns"
column dragconfigure
column dragcget
column id	replaces "column index"
notify linkage
column list	Old syntax (supported but deprecated): -
column order

Item Command

+ + + + + + + + + + +

notify linkage <eventName>

notify linkage <eventName-detail>

Removed	What -to use -instead
item index	item order
New	Comment	notify uninstall
see notify +install +above	item compare	replaces "compare"

Style Layout Options

How +it changed
item id
replaces "index"
item order	Usage +Changed	replaces "item index"
item range	replaces "range"

Notify Command

+ + + + + + + + + + +

$T style layout $S $E -iexpand we

notify install event eventName

notify install detail eventName detail

notify linkage eventName detail

- - - - - -

notify linkage <eventName>

- - - - - -

notify linkage <eventName-detail>

Arguments/Result -Changed	What -changed
Two new flags "x' and "y" are allowed. Previously, only +the +-ipadx and -ipady padding could be expanded by this option. The new xy +flags expand the display area of the element, not the padding. To +update your code, you will probably want to change this: -
notify generate + + + + + + + + + + + + + + + + + + + + + + $T style layout $S $E -iexpand x -	Added optional percentsCommand -argument
notify install	Old syntax (supported but deprecated): +
New - - - - - - notify install <eventName> - - - - - - notify install <eventName-detail> +

notify linkage
Old syntax (supported but deprecated): - - - - - - - - - - - - notify linkage eventName +
-height
-maxheight	notify uninstall	see notify -install -above

Style Layout Options

- - - - - -

$T style layout $S $E -iexpand x

-maxwidth
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 -flags expand the display area of the element, not the padding. To -update your code, you will probably want to change this: - - - - - - - - - - - - $T style layout $S $E -iexpand we +	-minheight
-minwidth	New -
-height		-sticky
	-maxheight
-maxwidth	-width

-minheight

Element Changes

A new element type window +was added. +See the new demo "Firefox Privacy" and the ELEMENTS section in the help +file.
All element types have a new +per-state boolean option called -draw.
The text +element type +has a new option called -textvariable. +See the new demo +"Textvariable" and the ELEMENTS section in the help file.

Event Changes

Element Changes

A new element type window -was added. -See the new demo "Firefox Privacy" and the ELEMENTS section in the help -file.
All element types have a new -per-state boolean option called -draw.
2 new %-substitution characters %P +and %? are +allowed in binding +scripts. See the EVENTS AND SCRIPT SUBSTITUTIONS section in the help +file.
The text -element type -has a new option called -textvariable. -See the new demo -"Textvariable" and the ELEMENTS section in the help file.
The new static event <ItemDelete> +is generated when items are deleted. See the EVENTS AND SCRIPT +SUBSTITUTIONS section in the help file.

Event Changes

+ -

2 new %-substitution characters %P -and %? are -allowed in binding -scripts. See the EVENTS AND SCRIPT SUBSTITUTIONS section in the help -file.

Library Script Changes

The new static event <ItemDelete> -is generated when items are deleted. See the EVENTS AND SCRIPT -SUBSTITUTIONS section in the help file.

filelist-bindings.tcl:

Library Script Changes

filelist-bindings.tcl:

3 new commands in the TreeCtrl namespace should be used to access the Priv(dragimage), Priv(edit) and Priv(sensitive) variables. The @@ -6831,6 +11708,11 @@ commands are SetDragImage, SetEditable and SetSensitive.
Two new dynamic events <Edit-begin> and <Edit-end> are @@ -6841,6 +11723,11 @@ generated when editing a file name.

treectrl.tcl:

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

Other Changes

On WinXP, the column headers and open/close buttons are drawn using the system theme if -usetheme @@ -6903,6 +11825,11 @@ is true. The sort arrow is drawn the old-fashioned way.
On OSX/Aqua, the column headers and open/close buttons are drawn @@ -6917,6 +11844,11 @@ 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 @@ -6959,6 +11911,11 @@ 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 @@ -6980,6 +11942,11 @@ scripts are found.

Demo Changes

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.

treectrl - Tk Commands

treectrl 2.2

pathName debug alloc

pathName debug cget option

pathName debug configure ?option? ?value? ?option value ...?

pathName debug dinfo

pathName debug dinfo option

pathName debug expose x1 y1 x2 y2

pathName debug scroll

pathName depth ?itemDesc?

-enable

-display

-enable boolean

-All other debugging options only take effect, +All other debugging options only take effect if this option is also switched on.

@@ -1205,11 +1205,21 @@ If you use an unusual color for this option (like pink), superflous screen redraws can be spotted more easily. Setting this option has only an effect if the debugging options -enable and -display are switched on. + +

+

-span boolean

+Debugging related to column spanning. + +

+

-textlayout boolean

+Debugging related to text-element layout. + -

pathName debug dinfo

pathName debug dinfo option

-Returns a string describing item layout. +Returns a string describing display-related stuff. Option must be one +of alloc, ditem, onscreen or range.

pathName debug expose x1 y1 x2 y2

diff --git a/doc/treectrl.man b/doc/treectrl.man index d0ca240..79362f8 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.48 2006/12/07 03:56:42 treectrl Exp $} -][manpage_begin treectrl n 2.2] + $Id: treectrl.man,v 1.49 2007/01/22 22:44:44 treectrl Exp $} +][manpage_begin treectrl n 2.2.2] [moddesc {Tk Commands}] [titledesc {Create and manipulate hierarchical multicolumn widgets}] -[require treectrl 2.2] +[require treectrl 2.2.2] [description] [list_begin definitions] @@ -750,7 +750,7 @@ Setting this option has only an effect if the debugging options [option -enable] and [option -display] are switched on. [opt_def [option -enable] [arg boolean]] -All other debugging options only take effect, +All other debugging options only take effect if this option is also switched on. [opt_def [option -erasecolor] [arg color]] @@ -761,10 +761,18 @@ If you use an unusual color for this option (like [const pink]), superflous screen redraws can be spotted more easily. Setting this option has only an effect if the debugging options [option -enable] and [option -display] are switched on. + +[opt_def [option -span] [arg boolean]] +Debugging related to column spanning. + +[opt_def [option -textlayout] [arg boolean]] +Debugging related to text-element layout. + [list_end] -[call [arg pathName] [cmd {debug dinfo}]] -Returns a string describing item layout. +[call [arg pathName] [cmd {debug dinfo}] [arg option]] +Returns a string describing display-related stuff. [arg Option] must be one +of [const alloc], [const ditem], [const onscreen] or [const range]. [call [arg pathName] [cmd {debug expose}] [arg x1] [arg y1] [arg x2] [arg y2]] Causes the area of the window bounded by the given window-coords to be diff --git a/doc/treectrl.n b/doc/treectrl.n index 76405c6..0a980c3 100644 --- a/doc/treectrl.n +++ b/doc/treectrl.n @@ -6,7 +6,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" $Id: treectrl.n,v 1.64 2006/12/07 03:56:42 treectrl Exp $ +'\" $Id: treectrl.n,v 1.65 2007/01/22 22:44:44 treectrl Exp $ .so man.macros .TH "treectrl" n 2.2 treectrl "Tk Commands" .BS @@ -87,7 +87,7 @@ package require \fBtreectrl 2.2\fR .sp \fIpathName\fR \fBdebug configure\fR ?\fIoption\fR? ?\fIvalue\fR? ?\fIoption value ...\fR? .sp -\fIpathName\fR \fBdebug dinfo\fR +\fIpathName\fR \fBdebug dinfo\fR \fIoption\fR .sp \fIpathName\fR \fBdebug expose\fR \fIx1\fR \fIy1\fR \fIx2\fR \fIy2\fR .sp @@ -1361,7 +1361,7 @@ Setting this option has only an effect if the debugging options \fB-enable\fR and \fB-display\fR are switched on. .TP \fB\fB-enable\fR\fR \fIboolean\fR -All other debugging options only take effect, +All other debugging options only take effect if this option is also switched on. .TP \fB\fB-erasecolor\fR\fR \fIcolor\fR @@ -1372,10 +1372,17 @@ If you use an unusual color for this option (like \fBpink\fR), superflous screen redraws can be spotted more easily. Setting this option has only an effect if the debugging options \fB-enable\fR and \fB-display\fR are switched on. +.TP +\fB\fB-span\fR\fR \fIboolean\fR +Debugging related to column spanning. +.TP +\fB\fB-textlayout\fR\fR \fIboolean\fR +Debugging related to text-element layout. .RE .TP -\fIpathName\fR \fBdebug dinfo\fR -Returns a string describing item layout. +\fIpathName\fR \fBdebug dinfo\fR \fIoption\fR +Returns a string describing display-related stuff. \fIOption\fR must be one +of \fBalloc\fR, \fBditem\fR, \fBonscreen\fR or \fBrange\fR. .TP \fIpathName\fR \fBdebug expose\fR \fIx1\fR \fIy1\fR \fIx2\fR \fIy2\fR Causes the area of the window bounded by the given window-coords to be diff --git a/shellicon/pkgIndex.tcl b/shellicon/pkgIndex.tcl index 6f7131c..a95c36c 100644 --- a/shellicon/pkgIndex.tcl +++ b/shellicon/pkgIndex.tcl @@ -1,2 +1,2 @@ if {[catch {package require Tcl 8.4}]} return -package ifneeded shellicon 2.2 [list load [file join $dir shellicon22.dll] shellicon] +package ifneeded shellicon 2.2.2 [list load [file join $dir shellicon22.dll] shellicon] -- cgit v0.12