What's New in TkTreeCtrl 2.0

TreeCtrl Configuration Options

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
-columnresizemode
-itemprefix
-minitemheight
-usetheme

Removed	What to use instead
-relief	-state
-sunken	-state
Renamed	New name
-arrowpad	-arrowpadx
Usage Changed	How it changed
-background	This is now a per-state option. See COLUMNS in the help file for valid state names.
New
-arrowbitmap
-arrowimage
-arrowpady
-maxwidth
-resize
-state
-textlines

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

Arguments/Result Changed	What changed
notify generate	Added optional percentsCommand argument
notify install	Old syntax (supported but deprecated): notify install event eventName notify install detail eventName detail New syntax: notify install <eventName> notify install <eventName-detail>
notify linkage	Old syntax (supported but deprecated): notify linkage eventName notify linkage eventName detail New syntax: notify linkage <eventName> notify linkage <eventName-detail>
notify uninstall	see notify install above

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 to this: $T style layout $S $E -iexpand x 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
-height
-maxheight
-maxwidth
-minheight
-minwidth
-sticky
-width

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.

2 new %-substitution characters %P and %? are allowed in binding scripts. See the EVENTS AND SCRIPT SUBSTITUTIONS 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.

The Priv(edit) variable, which is used to specify which text elements may be edited, now has the same format as Priv(sensitive). Previously only elements in the first column could be edited.
3 new commands in the TreeCtrl namespace should be used to access the Priv(dragimage), Priv(edit) and Priv(sensitive) variables. The commands are SetDragImage, SetEditable and SetSensitive.
Two new dynamic events <Edit-begin> and <Edit-end> are 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 by Apple's user-interface guidelines.

On WinXP, the column headers and open/close buttons are drawn using the system theme if -usetheme is true. The sort arrow is drawn the old-fashioned way.
On OSX/Aqua, the column headers and open/close buttons are drawn using the system theme if -usetheme is true. The sort arrow will be drawn by the Appearance Manager as well. This will override the -arrowside and -arrowgravity 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 file and the new demo "Firefox Privacy".
The new item description end is equivalent to last.
If you have version 1.1 installed, replace the old pkgIndex.tcl file with the one from this version (but replace the version number 2.0 with 1.1). Otherwise the old pkgIndex.tcl file will set the TREECTRL_LIBRARY variable which will override where the library 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.