From f49877462d0bd04139e1f783480bb746259142b3 Mon Sep 17 00:00:00 2001 From: treectrl Date: Fri, 27 Oct 2006 04:52:23 +0000 Subject: Sync with current features. --- doc/What's New in TkTreeCtrl.html | 308 +++++++++++++++++++++++++++++++++----- 1 file changed, 271 insertions(+), 37 deletions(-) diff --git a/doc/What's New in TkTreeCtrl.html b/doc/What's New in TkTreeCtrl.html index 740c8f2..d7570f8 100644 --- a/doc/What's New in TkTreeCtrl.html +++ b/doc/What's New in TkTreeCtrl.html @@ -1,7 +1,7 @@ - + @@ -22,7 +22,7 @@

What's New in TkTreeCtrl 2.2

-

Item Command

+

Column Configuration Options

@@ -34,12 +34,14 @@ - + + + + + @@ -48,12 +50,10 @@ changed - + - + @@ -62,11 +62,10 @@ whose ancestors are all expanded etc). - + - + @@ -75,11 +74,41 @@ specifies an initial list of tags for created items. - + - + + + + + + + + + + + + + @@ -88,6 +117,29 @@ matches multiple items. + + + + + + + + +
Arguments/Result -ChangedRenamed
- 		What -changedNew +name
item count-tagNew option -visible -added to return the number of items that are displayed (i.e., those -whose ancestors are all expanded etc).-tags
item createNewNew option -tags -specifies an initial list of tags for created items.Comment
item id-lockReturns a list of item ids if the item description -matches multiple items.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.
-uniformThese 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.
-weight
+ + +

Column Command

+ + + + + + + + + + + @@ -100,11 +152,13 @@ matches multiple items. - + - + @@ -113,13 +167,25 @@ an item. - + - + + + + + + + + + + + + + + + + @@ -130,7 +196,7 @@ bindings.
New
item descendantscolumn tag addReturns the ids of the children, grandchildren, etc of -an item.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 enabledcolumn tag exprGets 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 -bindings.
column tag names
column tag remove
-

Tag Command

+

Item Configuration Options

@@ -154,14 +220,148 @@ bindings. - + + + + + + + + + + + +
tag add-tagsTags are used to identify groups of items.
+ + +

Item Command

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + @@ -202,7 +402,7 @@ returns 1 if  an item has tag "a" or "b". - + @@ -229,14 +429,14 @@ returns every tag assigned to any item. - + @@ -250,10 +450,21 @@ will remove tags "b" and "c" from any items that have them.
Arguments/Result +ChangedWhat +changed
item countNew option -visible +added to return the number of items that are displayed (i.e., those +whose ancestors are all expanded etc).
item createNew option -tags +specifies an initial list of tags for created items.
item idReturns 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.
NewComment
item descendantsReturns the ids of the children, grandchildren, etc of +an item.
item enabledGets 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 tag add all {a b c}
+ 
.t item tag add all {a b c}
will add tags "a", "b" and "c" to every item.
@@ -176,21 +376,21 @@ will add tags "a", "b" and "c" to every item.
tag expritem tag expr Evaluate a tag expression against items. For example:
- 
.t tag expr $item a
+ 
.t item tag expr $item a
returns 1 if an item has tag "a". Also:
- 
.t tag expr $item a||b
+ 
.t item tag expr $item a||b
returns 1 if  an item has tag "a" or "b".
tag namesitem tag names Return a list of tag names assigned to items. For @@ -210,14 +410,14 @@ example:
- 
.t tag names $item
+ 
.t item tag names $item
returns the tag list for an item, and:
- 
.t tag names all
+ 
.t item tag names all
returns every tag assigned to any item.
tag removeitem tag remove Remove tags from items. For example:
- 
.t tag remove all {b c}
+ 
.t item tag remove all {b c}
will remove tags "b" and "c" from any items that have them.
+ + + + + + + + +
+ +

Item Tags

-Tags are textual labels applied to items to group them together. 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.
@@ -449,6 +660,17 @@ call:
+

Column Descriptions

+ + +New keywords list, +range and tag can be used to +match multiple columns.
+ + +New qualifiers state, +tag and !visible can be used +to restrict which columns are specified.

Demo Changes

@@ -457,7 +679,15 @@ call:
  • New demo "My Computer". Demonstrates disabled items used as headers.
    • -
  • The "Big List" and "Firefox Privacy" demos were changed to use the new -clip option of window elements.
    • + + +
  • 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.
    • @@ -492,6 +722,10 @@ binding scripts. 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 the span of an item-column changed.
    • + + -- cgit v0.12