From cf436c12cdc13de9e5e3bbe5b8d546e3a14169e5 Mon Sep 17 00:00:00 2001
From: treectrl
Date: Sun, 19 Nov 2006 00:56:19 +0000
Subject: Added 2 optional arguments to [selection get] to perform lindex- and
lrange-like operations on the sorted list of selected items.
---
doc/What's New in TkTreeCtrl.html | 11105 ++++--------------------------------
doc/treectrl.html | 23 +-
doc/treectrl.man | 19 +-
doc/treectrl.n | 23 +-
4 files changed, 1228 insertions(+), 9942 deletions(-)
diff --git a/doc/What's New in TkTreeCtrl.html b/doc/What's New in TkTreeCtrl.html
index 4fc90c5..df316b7 100644
--- a/doc/What's New in TkTreeCtrl.html
+++ b/doc/What's New in TkTreeCtrl.html
@@ -1,10817 +1,2080 @@
-
+
+
+ What's New in TkTreeCtrl
+
+
+
+What's New in TkTreeCtrl 2.2
+TreeCtrl Configuration Options
+
+
-
-
-
-
-
-
-
-
-
-
-
+
+ Deprecated |
+ What
+to use
+instead |
+
+
+ -defaultstyle |
+ The -itemstyle option of a column. |
+
+
+
+TreeCtrl Command
-
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- What's New in TkTreeCtrl
-
-
+
+ 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 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
+ |
-What's New in TkTreeCtrl 2.2
+
+
+
+Column Configuration Options
+
+
+
+ Renamed
+ |
+ New
+name |
+
+
-TreeCtrl Configuration Options
+ -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
+horizontally. Valid values for this option are none (the default), left or right. |
+
+
+ -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:
-
+ .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. |
-
-
+Column Command
+
+
+ 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. |
- Deprecated |
-
-
-
-
-
+
+
+ New |
+ Comment |
+
+
- What
-to use
-instead |
+ 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 |
- -defaultstyle |
-
-
-
+
+
+ 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. |
- The -itemstyle option of a column. |
+
+
+ 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 |
-TreeCtrl Command
+ 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
- | Arguments/Result
-Changed |
+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:
+
+New modifiers were added to match multiple items:
+
+ - The modifier ancestors
+operates like the item
+ancestors command:
+
.t item id "$item ancestors"
+
- What
-changed |
+ - 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
- contentbox |
+
+ - 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.
- 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. |
+
+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.
-Column Configuration Options
+ 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
+
+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.
- -itemstyle |
+
+
+What's New in TkTreeCtrl 2.0
+TreeCtrl Configuration Options
+
- Specifies the name of a style to set in this column for
-newly-created items. This option replaces the treectrl option
--defaultstyle. |
+
+
+ Replaced |
+ What
+to use
+instead |
+
+
+ -openbuttonimage |
+ -buttonimage |
+
+ -closedbuttonimage |
+ -buttonimage |
+
+
+ -openbuttonbitmap |
+ -buttonbitmap |
+
+
+ -closedbuttonbitmap |
+ -buttonbitmap |
- -uniform |
+
+
+ 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 |
- These two options
-operate the same as the grid geometry manager options of the same name.
-For example:
-
+ | 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 |
+ |
+
-
-
-
-
-
-
-
-
-
-
- .t column configure 0 -uniform a
.t column configure 1 -uniform a
+
+ -columnprefix |
+ |
+
+
+ -columnresizemode |
+ |
+
+
+ -itemprefix |
+ |
-will give columns 0 and 1 the same requested width, whichever is the larger of the two columns. And:
+
+
+ -minitemheight |
+ |
+
+
+ -usetheme |
+ |
+
+
+
-
-
-
-
-
-
-
-
-
-
- .t column configure 0 -uniform a -weight 2
.t column configure 1 -uniform a
+TreeCtrl Commands
+
+
+
+ Deprecated |
+ What
+to use
+instead |
+
+
+ compare |
+ item compare |
-will give column 0 twice the maximum of the requested widths of columns 0 and 1. And:
+
+
+ index |
+ item id |
+
+
+ numcolumns |
+ column count |
+
-
-
-
-
-
-
-
-
-
- .t column configure 0 -expand yes -weight 2
.t column configure 1 -expand yes
+
+ numitems |
+ item count |
+
+
+ range |
+ item range |
+
+
+
-will give column 0 twice the extra space as column 1.
+Column Configuration Options
+
+
+
+ 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. |
- -weight |
-
+
+
+ New
+ |
+ |
+
+
+ -arrowbitmap
+ |
+ |
+
+ -arrowimage |
+ |
+
+
+ -arrowpady |
+ |
+
+
+ -maxwidth |
-
-
-
-
-
-
-
-
-
-
-
-
-
+ |
+
+
+ -resize |
+ |
+
+
+ -state |
+ |
+
-Column Command
+
+ -textlines |
+ |
+
+
+
+Column Command
+
+
+
+ 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. |
-
- 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:
+ New |
-
- .t column count {tag a^b}
+ Comment |
-will return the number of columns with either tag "a" or "b", but not both.
+
+ column compare |
+ |
+
+
+ column count |
+ replaces "numcolumns" |
+
+
+ column dragconfigure |
+ |
- New |
+
+
+ column dragcget |
+ |
+
+
+ column id |
+ replaces "column index" |
+
+
+ column list |
- Comment |
+ |
+
+
+ column order |
+ |
+
+
+
+Item Command
+
+
+
-
+ Removed |
+ What
+to use
+instead |
+
+
+ item index |
+ item order |
+
+
+ New |
+ Comment |
+
+ item compare |
+ replaces "compare" |
+
+
+ item count |
+ replaces "numitems" |
+
+
+ item id |
+ replaces "index" |
- column tag add |
-
-
-
-
-
-
+
+
+ item order |
+ replaces "item index" |
+
- 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. |
+
+ item range |
+ replaces "range" |
+
+
+
+Notify Command
+
+
+
+ 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>
+ |
+
+
- column tag expr |
-
+ 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 |
+
+
+
+Style Layout Options
+
-
-
+
+ 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
- column tag names |
+
+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 |
+ |
- column tag remove |
-
+
+
+ -width |
+ |
+
+
+
+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
+
+ - 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.
+
+Library Script Changes
+filelist-bindings.tcl:
+
+ - 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.
+
+treectrl.tcl:
+
+ - 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.
+
+Other Changes
+
+ - 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.
-Item Configuration 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.
+
+Demo Changes
+
+ - New demo "Firefox Privacy". Demonstrates the new window element type
+and -indent
+style layout option.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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:
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-New modifiers were added to match multiple items:
-
-
-
-
-
-
-
-
-
-
-
-
- - The modifier ancestors
-operates like the item
-ancestors command:
-
-
-
-
-
-
-
-
-
-
-
.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
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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 |
-
-
-
-
-
-
-
-
-
-
-
- |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-TreeCtrl Commands
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Deprecated |
-
-
-
-
-
-
-
-
-
-
-
- What
-to use
-instead |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- compare |
-
-
-
-
-
-
-
-
-
-
-
- item compare |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- index |
-
-
-
-
-
-
-
-
-
-
-
- item id |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- numcolumns |
-
-
-
-
-
-
-
-
-
-
-
- column count |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- numitems |
-
-
-
-
-
-
-
-
-
-
-
- item count |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- range |
-
-
-
-
-
-
-
-
-
-
-
- item range |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Column Configuration Options
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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 |
-
-
-
-
-
-
-
-
-
-
-
- |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Column Command
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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 |
-
-
-
-
-
-
-
-
-
-
-
- |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Item Command
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Removed |
-
-
-
-
-
-
-
-
-
-
-
- What
-to use
-instead |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- item index |
-
-
-
-
-
-
-
-
-
-
-
- item order |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- New |
-
-
-
-
-
-
-
-
-
-
-
- Comment |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- item compare |
-
-
-
-
-
-
-
-
-
-
-
- replaces "compare" |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- item count |
-
-
-
-
-
-
-
-
-
-
-
- replaces "numitems" |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- item id |
-
-
-
-
-
-
-
-
-
-
-
- replaces "index" |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- item order |
-
-
-
-
-
-
-
-
-
-
-
- replaces "item index" |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- item range |
-
-
-
-
-
-
-
-
-
-
-
- replaces "range" |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Notify Command
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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 |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Style Layout Options
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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 |
-
-
-
-
-
-
-
-
-
-
-
- |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-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
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 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.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Library Script Changes
-
-
-
-
-
-
-
-
-
-
-
-filelist-bindings.tcl:
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 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.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-treectrl.tcl:
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 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.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Other Changes
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - 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.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-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.
-
-
-
-
-
-
-
+ - 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.
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/treectrl.html b/doc/treectrl.html
index d7281e8..d578ee0 100644
--- a/doc/treectrl.html
+++ b/doc/treectrl.html
@@ -1,10 +1,10 @@
-
treectrl - Tk Commands
-
@@ -193,7 +193,7 @@ package require treectrl 2.2
pathName selection anchor ?itemDesc? |
pathName selection clear ?first? ?last? |
pathName selection count |
-pathName selection get |
+pathName selection get ?first? ?last? |
pathName selection includes itemDesc |
pathName selection modify select deselect |
pathName style option ?element? ?arg arg ...? |
@@ -2542,12 +2542,19 @@ Returns an integer indicating the number
of items in the treectrl that are currently selected.
-pathName selection get
+pathName selection get ?first? ?last?
-Returns a list containing the item ids of
-all of the items in the treectrl that are currently selected.
-If there are no items selected in the treectrl then an empty
-string is returned.
+When no additional arguments are given, the result is an unsorted list
+containing the item ids of all of the items in the treectrl that are currently selected.
+If there are no items selected in the treectrl, then an empty string is returned.
+The optional arguments first and last are treated as indices into
+the sorted list of selected items; these arguments allow in-place lindex
+and lrange operations on the selection.
+ |
+.t selection get 0 ; # return the first selected item
+.t selection get end ; # return the last selected item
+.t selection get 1 end-1 ; # return every selected item except the first and last
+ |
pathName selection includes itemDesc
diff --git a/doc/treectrl.man b/doc/treectrl.man
index ad4329f..845d7c0 100644
--- a/doc/treectrl.man
+++ b/doc/treectrl.man
@@ -3,7 +3,7 @@
See the file "license.terms" for information on usage and redistribution
of this file, and for a DISCLAIMER OF ALL WARRANTIES.
- $Id: treectrl.man,v 1.42 2006/11/18 04:40:10 treectrl Exp $}
+ $Id: treectrl.man,v 1.43 2006/11/19 00:56:19 treectrl Exp $}
][manpage_begin treectrl n 2.2]
[moddesc {Tk Commands}]
[titledesc {Create and manipulate hierarchical multicolumn widgets}]
@@ -1903,11 +1903,18 @@ selection.
Returns an integer indicating the number
of items in the treectrl that are currently selected.
-[call [arg pathName] [cmd {selection get}]]
-Returns a list containing the item ids of
-all of the items in the treectrl that are currently selected.
-If there are no items selected in the treectrl then an empty
-string is returned.
+[call [arg pathName] [cmd {selection get}] [opt [arg first]] [opt [arg last]]]
+When no additional arguments are given, the result is an unsorted list
+containing the item ids of all of the items in the treectrl that are currently selected.
+If there are no items selected in the treectrl, then an empty string is returned.
+The optional arguments [arg first] and [arg last] are treated as indices into
+the sorted list of selected items; these arguments allow in-place [cmd lindex]
+and [cmd lrange] operations on the selection. For example:
+[example_begin]
+.t selection get 0 ; # return the first selected item
+.t selection get end ; # return the last selected item
+.t selection get 1 end-1 ; # return every selected item except the first and last
+[example_end]
[call [arg pathName] [cmd {selection includes}] [arg itemDesc]]
Returns 1 if the item described by [arg itemDesc] is currently
diff --git a/doc/treectrl.n b/doc/treectrl.n
index da1e794..9b5768a 100644
--- a/doc/treectrl.n
+++ b/doc/treectrl.n
@@ -6,7 +6,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" $Id: treectrl.n,v 1.58 2006/11/18 04:40:10 treectrl Exp $
+'\" $Id: treectrl.n,v 1.59 2006/11/19 00:56:19 treectrl Exp $
.so man.macros
.TH "treectrl" n 2.2 treectrl "Tk Commands"
.BS
@@ -311,7 +311,7 @@ package require \fBtreectrl 2.2\fR
.sp
\fIpathName\fR \fBselection count\fR
.sp
-\fIpathName\fR \fBselection get\fR
+\fIpathName\fR \fBselection get\fR ?\fIfirst\fR? ?\fIlast\fR?
.sp
\fIpathName\fR \fBselection includes\fR \fIitemDesc\fR
.sp
@@ -2456,11 +2456,20 @@ selection.
Returns an integer indicating the number
of items in the treectrl that are currently selected.
.TP
-\fIpathName\fR \fBselection get\fR
-Returns a list containing the item ids of
-all of the items in the treectrl that are currently selected.
-If there are no items selected in the treectrl then an empty
-string is returned.
+\fIpathName\fR \fBselection get\fR ?\fIfirst\fR? ?\fIlast\fR?
+When no additional arguments are given, the result is an unsorted list
+containing the item ids of all of the items in the treectrl that are currently selected.
+If there are no items selected in the treectrl, then an empty string is returned.
+The optional arguments \fIfirst\fR and \fIlast\fR are treated as indices into
+the sorted list of selected items; these arguments allow in-place \fBlindex\fR
+and \fBlrange\fR operations on the selection.
+.nf
+
+.t selection get 0 ; # return the first selected item
+.t selection get end ; # return the last selected item
+.t selection get 1 end-1 ; # return every selected item except the first and last
+
+.fi
.TP
\fIpathName\fR \fBselection includes\fR \fIitemDesc\fR
Returns 1 if the item described by \fIitemDesc\fR is currently
--
cgit v0.12