From dc7190f555445beab0d97f8656f3685a6e237bf2 Mon Sep 17 00:00:00 2001 From: treectrl Date: Wed, 27 Sep 2006 02:10:47 +0000 Subject: Added -clip option to window elements. --- doc/What's New in TkTreeCtrl.html | 5366 +++++++------------------------------ 1 file changed, 953 insertions(+), 4413 deletions(-) diff --git a/doc/What's New in TkTreeCtrl.html b/doc/What's New in TkTreeCtrl.html index 0716cd0..3532096 100644 --- a/doc/What's New in TkTreeCtrl.html +++ b/doc/What's New in TkTreeCtrl.html @@ -1,5224 +1,1764 @@ - - - - - - - - - - - - - - + + What's New in TkTreeCtrl - - - - - - - - - - - - - - - - - - - - What's New in TkTreeCtrl + -

What's New in TkTreeCtrl 2.2

-

Item Command

- - +

What's New in TkTreeCtrl 2.2

+

Item Command

+ + + - - - + - - + - - + - + + + + - + + + - -
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.
- - - - - - - - - - - - + + - - - + + + - - - - - - - - - - - - - - - + - - - + + + + +
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.
Returns a list of item ids if the item description +matches multiple items.
NewComment
item descendantsReturns the ids of the children, grandchildren, etc of +an item.Returns 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 bindings.
-

Tag Command

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

Tag Command

- - - - + + - - - - - - - - - - - - - - - - - - + + + + + + + - + + + + + +
NewComment
tag addAdd tags to items. For example:
+ 
.t tag add all {a b c}
+ will add tags "a", "b" and "c" to every item.
+
tag exprEvaluate a tag expression against items. For example:
+ 
.t tag expr $item a
+ returns 1 if an item has tag "a". Also:
+ 
.t tag expr $item a||b
+ returns 1 if  an item has tag "a" or "b".
tag namesReturn a list of tag names assigned to items. For example:
+ + 		Return a list of tag names assigned to items. For +example:
+ 
.t tag names $item
+ returns the tag list for an item, and:
+ 
.t tag names all
+ returns every tag assigned to any item.
tag removeRemove tags from items. For example:
+ 
.t 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 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.
+ +

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: + New qualifiers were added to refine which items are matched:
+ -Also, the keyword all may now be followed by a list of qualifiers: For example:
+ +Also, 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"
-The following commands can now operate on multiple items in a single call:
+ +The following commands can now operate on multiple items in a single +call:
+ -

Demo Changes

- -

Bug Fixes

- -
+
  • item id
    • +
  • item image
    • +
  • item style map
    • +
  • item style set
    • +
  • item state forcolumn
    • -

    What's New in TkTreeCtrl 2.1.1

    +
  • item state set
    • +
  • item remove
    • -

    Column Command

    +
  • item span
    • +
  • item text
    • + +

    Demo Changes

    + +

    Bug Fixes

    + +
    +

    What's New in TkTreeCtrl 2.1.1

    +

    Column Command

    - - + + + + + + + + + +
    Arguments/Result +ChangedWhat +changed
    column delete
    - +     		Added an optional second argument allowing a range of +columns to be deleted.
    - +

    Bug Fixes

    + +

    Other Changes

    - Arguments/Result -Changed + +

    Demo Changes

    - What changed + +
    +

    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

    + + + + + + + + + + + - + + + + + + +
    NewComment
    -itemwidth
    +
    -itemwidthequalcolumn delete
    +     		Deprecates the column -widthhack option.
    -itemwidthmultipleDeprecates the column -stepwidth option.
    - - - - +

    Column Configuration Options

    + + + - + + + - - - -
    Added an optional second argument allowing a range of columns to be deleted.DeprecatedWhat +to use +instead
    + -stepwidth + treectrl's -itemwidthmultiple option -

    Bug Fixes

    + + -