From 058cb4b8f1c5023d97323753cafec29702a9e2ac Mon Sep 17 00:00:00 2001 From: treectrl Date: Thu, 7 Dec 2006 03:56:41 +0000 Subject: Deprecated the -draw option of every element. The new style layout option -draw should be used instead. --- doc/What's New in TkTreeCtrl.html | 994 +++++++++++++++++++++++++++++++++++++- doc/treectrl.html | 17 +- doc/treectrl.man | 14 +- doc/treectrl.n | 14 +- 4 files changed, 1034 insertions(+), 5 deletions(-) diff --git a/doc/What's New in TkTreeCtrl.html b/doc/What's New in TkTreeCtrl.html index 97809c2..c168628 100644 --- a/doc/What's New in TkTreeCtrl.html +++ b/doc/What's New in TkTreeCtrl.html @@ -1,12 +1,14 @@ - + + + @@ -16,6 +18,7 @@ + @@ -26,6 +29,8 @@ + + What's New in TkTreeCtrl @@ -37,98 +42,125 @@ +

What's New in TkTreeCtrl 2.2.x

+

Column Configuration Options

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

+ + + + + + + + + + + + @@ -137,62 +169,79 @@ it changed +

Style Layout Changes

+ +

Item Descriptions

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

Bug Fixes

+ +

What's New in TkTreeCtrl 2.2

@@ -200,36 +249,42 @@ using the -minheight or + + + + @@ -238,36 +293,43 @@ instead + + + + + + + @@ -279,30 +341,35 @@ instead +

TreeCtrl Command

+
Usage ChangedHow it changed
-buttonThe 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.
DeprecatedWhat to use instead
-defaultstyleThe -itemstyle option of a column.
+ + + @@ -310,6 +377,7 @@ Changed + @@ -317,24 +385,28 @@ changed + + + + + + + + + + + + + + + + + + + @@ -515,42 +617,49 @@ will return the bounds of the left-locked and right-locked columns. +

Column Configuration Options

+
Arguments/Result ChangedWhat changed
contentboxThe 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 @@ -344,24 +416,28 @@ small.
selection getAccepts 2 optional arguments to allow in-place lindex and lrange queries of the selection. For example:
@@ -369,6 +445,8 @@ the selection. For example:
+ + @@ -379,54 +457,63 @@ the selection. For example:
+
NewComment
bboxReturns the bounding box of different areas of the window. For example:
@@ -434,6 +521,8 @@ window. For example:
+ + @@ -444,12 +533,15 @@ window. For example:
+ will return the bounds of the window, and:
+ + @@ -460,12 +552,15 @@ will return the bounds of the window, and:
+ will return the bounds of the column headers, and:
+ + @@ -476,12 +571,15 @@ will return the bounds of the column headers, and:
+ will return the same result as the [contentbox] command, and:
+ + @@ -492,18 +590,22 @@ will return the same result as the [contentbox] command, and:
+ will return the bounds of the left-locked and right-locked columns.
+ + + + @@ -558,72 +667,84 @@ name + + + + + + + + + + + + + + + @@ -659,24 +784,28 @@ newly-created items. This option replaces the treectrl option + + + + + + + + + + @@ -770,30 +914,35 @@ will give column 0 twice the extra space as column 1. +

Column Command

+
Renamed
+ 		New name
-tag-tags
NewComment
-lockThis option allows columns to stick to the left or right edge of the window. Locked columns can scroll vertically but not @@ -633,24 +754,28 @@ horizontally. Valid values for this option are +
-itemstyleSpecifies the name of a style to set in this column for newly-created items. This option replaces the treectrl option -defaultstyle.
-uniformThese two options operate the same as the grid geometry manager options of the same name. For example:
@@ -685,6 +814,8 @@ For example:
+ + @@ -695,6 +826,7 @@ For example:
+ will give columns 0 and 1 the same requested width, whichever is the larger of the two columns. And:
@@ -702,6 +834,8 @@ larger of the two columns. And:
+ + @@ -712,6 +846,7 @@ larger of the two columns. And:
+ will give column 0 twice the maximum of the requested widths of columns 0 and 1. And:
@@ -719,6 +854,8 @@ will give column 0 twice the maximum of the requested widths of columns + + @@ -729,36 +866,43 @@ will give column 0 twice the maximum of the requested widths of columns + will give column 0 twice the extra space as column 1.
-weight
+ + + @@ -801,6 +950,7 @@ Changed + @@ -808,24 +958,28 @@ changed + + + + @@ -867,48 +1027,56 @@ both. + + + + + + + + + + + + + + + + + + + + @@ -989,60 +1169,70 @@ word "tail" in column descriptions. +

Item Configuration Options

+
Arguments/Result ChangedWhat changed
column countTakes an optional column-description argument; the result is the number of columns that match the column description. For example:
@@ -834,6 +988,8 @@ the number of columns that match the column description. For example:
+ + @@ -844,12 +1000,15 @@ the number of columns that match the column description. For example:
+ will return the number of columns whose -visible option is true, and:
+ + @@ -860,6 +1019,7 @@ will return the number of columns whose -visible option is true, and:
+ will return the number of columns with either tag "a" or "b", but not both.
NewComment
column tag addColumns 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 @@ -918,66 +1086,78 @@ word "tail" in column descriptions.
column tag expr
column tag names
column tag remove
+ + + + + + + + + + + @@ -1070,30 +1263,35 @@ found in the man page. +

Item Command

+
NewComment
-tagsTags are textual labels applied to items to group them. Tags do not affect the appearance or behaviour of items. Tags can be used in @@ -1053,12 +1243,15 @@ found in the man page.
+ + + @@ -1101,6 +1299,7 @@ Changed + @@ -1108,24 +1307,28 @@ changed + + + + @@ -1167,24 +1376,28 @@ both. + + + + @@ -1192,24 +1405,28 @@ specifies an initial list of tags for created items. + + + + + + + + + + + + @@ -1298,24 +1529,28 @@ an item. + + + + + + + + + will add tags "a", "b" and "c" to every item.
+ + + + + + + + + + + + + + will remove tags "b" and "c" from any items that have them. + + + @@ -1541,12 +1814,14 @@ 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.
@@ -1554,12 +1829,14 @@ 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 @@ -1571,24 +1848,28 @@ 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, @@ -1602,36 +1883,42 @@ demos. + 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:
+ + 
.t item id "all depth 2" ; # find all items that are children of the root's children
.t item id "depth 2" ; # ditto
@@ -1759,84 +2065,98 @@ matches items at a given depth in the heirarchy: +
+ +
+ The keyword all may now be followed by a list of qualifiers. For example:
@@ -1844,12 +2164,14 @@ 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 @@ -1859,6 +2181,7 @@ qualifiers. For example:
+ 
.t item id "!visible state myState" ; # same as the previous example
@@ -1866,18 +2189,21 @@ qualifiers. For example:
+
+

Column Descriptions

+ New keywords list and range can be used to @@ -1887,6 +2213,7 @@ match multiple columns.
+ New qualifiers state, tag, !tail and !visible can be used to restrict which columns are specified.
@@ -1895,6 +2222,7 @@ to restrict which columns are specified.
+ The keyword all may be followed by a list of qualifiers.
@@ -1902,6 +2230,7 @@ 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 @@ -1912,6 +2241,7 @@ qualifiers. + Many commands can now operate on multiple items and/or columns by using the improved item descriptions and column descriptions mentioned above. For example: @@ -1922,24 +2252,28 @@ For example: + +

Demo Changes

+ +

Misc Changes

+ +

Bug Fixes

+ +

What's New in TkTreeCtrl 2.1.1

@@ -2101,30 +2456,35 @@ without a white background under OSX. +

Column Command

+
Arguments/Result ChangedWhat changed
item countTakes an optional item-description argument; the result is the number of items that match the item description. For example:
@@ -1133,6 +1336,8 @@ is the number of items that match the item description. For example:
+ + @@ -1143,6 +1348,7 @@ is the number of items that match the item description. For example:
+ will return the number of items that are displayed (i.e., those whose ancestors are all expanded, -visible options are true, etc), and:
@@ -1150,6 +1356,8 @@ whose ancestors are all expanded, -visible options are true, etc), and:
+ + @@ -1160,6 +1368,7 @@ whose ancestors are all expanded, -visible options are true, etc), and:
+ will return the number of items with either tag "a" or "b", but not both.
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:
@@ -1217,6 +1434,8 @@ matches multiple items. For example:
+ + @@ -1227,12 +1446,15 @@ matches multiple items. For example:
+ will return a list of ids for all items, and:
+ + @@ -1243,54 +1465,63 @@ will return a list of ids for all items, and:
+ 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 @@ -1325,30 +1560,36 @@ and mouse bindings.
item tag addAdd tags to items. For example:
+ + @@ -1359,42 +1600,50 @@ and mouse bindings.
item tag exprEvaluate a tag expression against items. For example:
+ + @@ -1405,12 +1654,15 @@ will add tags "a", "b" and "c" to every item.
+ returns 1 if an item has tag "a". Also:
+ + @@ -1421,30 +1673,35 @@ returns 1 if an item has tag "a". Also:
+ returns 1 if  an item has tag "a" or "b".
item tag namesReturn a list of tag names assigned to items. For example:
@@ -1452,6 +1709,8 @@ example:
+ + @@ -1462,12 +1721,15 @@ example:
+ returns the tag list for an item, and:
+ + @@ -1478,36 +1740,43 @@ returns the tag list for an item, and:
+ returns every tag assigned to any item.
item tag removeRemove tags from items. For example:
+ + @@ -1518,18 +1787,22 @@ returns every tag assigned to any item.
+ + + @@ -2132,6 +2492,7 @@ Changed + @@ -2139,30 +2500,35 @@ changed + + + + @@ -2170,12 +2536,15 @@ columns to be deleted. + + + @@ -2187,18 +2556,21 @@ columns to be deleted. +

Bug Fixes

+ +

Other Changes

+ +

Demo Changes

+ +

What's New in TkTreeCtrl 2.1

@@ -2324,6 +2713,7 @@ window. + This version should be backwards compatible with 2.0, except for a few obscure changes.
@@ -2331,126 +2721,148 @@ obscure changes.
+

TreeCtrl Configuration Options

+
Arguments/Result ChangedWhat changed
column delete
+ 		Added an optional second argument allowing a range of columns to be deleted.
+ + + + + + + + + + + + + + + + + + + @@ -2462,36 +2874,42 @@ obscure changes.
+

Column Configuration Options

+
NewComment
-itemwidth
+
-itemwidthequalDeprecates the column -widthhack option.
-itemwidthmultipleDeprecates the column -stepwidth option.
+ + + + @@ -2500,60 +2918,71 @@ instead + + + + + + + + + + + @@ -2565,72 +2994,85 @@ instead +

Element Command

+
DeprecatedWhat to use instead
-stepwidthtreectrl's -itemwidthmultiple option
-widthhacktreectrl's -itemwidthequal option
+ + + + + + + + + + + @@ -2642,72 +3084,85 @@ instead +

Item Configuration Options

+
NewComment
element perstateLike [item element perstate].
+ + + + + + + + + + + @@ -2719,36 +3174,42 @@ instead +

Item Command

+
NewComment
-heightOverrides the treectrl's -itemheight option
+ + + + @@ -2757,66 +3218,77 @@ instead + + + + + + + + + + + @@ -2824,6 +3296,7 @@ Changed + @@ -2831,24 +3304,28 @@ changed + + + + @@ -2856,24 +3333,28 @@ assigned to the column. + + + + @@ -2881,24 +3362,28 @@ assigned to the column. + + + + @@ -2915,18 +3401,21 @@ incompatibility + + + @@ -2934,6 +3423,7 @@ Changed + @@ -2941,24 +3431,28 @@ changed + + + + + + + + + + + + @@ -3030,24 +3533,28 @@ incompatibility + + + + @@ -3055,72 +3562,84 @@ string per column. + + + + + + + + + + + + @@ -3189,24 +3718,28 @@ incompatibility + + + + + + + @@ -3237,6 +3774,7 @@ columns.
+

Notify Command

@@ -3244,60 +3782,70 @@ Command +
DeprecatedWhat to use instead
item element actualitem element perstate
item complexitem element configure
Behaviour ChangedWhat changed
item bboxNo longer returns an error if no style had been assigned to the column.
item state forcolumnNo longer returns an error if no style had been assigned to the column.
item style setDoes nothing when replacing a style with the same style. Previously the old style was freed before assigning the new style, @@ -2908,6 +3393,7 @@ losing the element config info if the old and new styles were the same.
+ Potential incompatibility
Arguments/Result ChangedWhat changed
item createAdded options: -count -height, -nextsibling, -open, -parent, -prevsibling, and -returnid. Multiple items may be created with one @@ -2968,24 +3462,28 @@ call using the -count option.
item element configureMultiple elements in multiple columns may be configured with a single call. Use '+' to separate elements, and ',' to separate @@ -2995,24 +3493,28 @@ columns. See the docs.
item style setWhen no column is specified, returns a list of one style name per column. Previously, the list would have less values than the number @@ -3023,6 +3525,7 @@ column(s).
+ Potential incompatibility
item textWhen no column is specified, returns a list of one string per column.
NewComment
item imagePartner to the [item text] command.
item element perstateNot really new, just renamed from [item element actual] to better describe what it does. Accepts a new optional argument which @@ -3131,12 +3650,14 @@ option.
+
+ The following options no longer return a default value if the per-state option itself does not have a value specified:
@@ -3144,6 +3665,8 @@ option itself does not have a value specified:
+ + @@ -3154,24 +3677,29 @@ option itself does not have a value specified:
+
  • bitmap -foreground, -background
    • +
  • border -relief
    • +
  • text -fill, -font
    • + + @@ -3182,6 +3710,7 @@ option itself does not have a value specified:
    + Potential incompatibility
    item spanA style may now be displayed over multiple adjacent columns.
    @@ -3214,18 +3747,22 @@ columns.
    +
    + + + + + + + + @@ -3305,12 +3853,15 @@ call. + + + @@ -3322,18 +3873,21 @@ call. +

    Style Layout Changes

    +
    NewComment
    notify unbind
    +     		Let's you unbind all scripts from an object with one call.
    + + + + @@ -3558,114 +4144,133 @@ instead + + + + + + + + + + + + + + + + + + + @@ -3673,6 +4278,7 @@ Changed + @@ -3680,24 +4286,28 @@ it changed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -3922,36 +4567,42 @@ buttons/lines. +

    TreeCtrl Commands

    +
    ReplacedWhat to use instead
    -openbuttonimage-buttonimage
    -closedbuttonimage-buttonimage
    -openbuttonbitmap-buttonbitmap
    -closedbuttonbitmap-buttonbitmap
    Usage ChangedHow it changed
    -backgroundmodeThe values "index" and "visindex" are deprecated. The value "order" should be used instead of "index", and @@ -3709,24 +4319,28 @@ index" command.
    -treecolumnThis 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 @@ -3737,180 +4351,211 @@ buttons/lines.
    New
    -backgroundimage
    -columnprefix
    -columnresizemode
    -itemprefix
    -minitemheight
    -usetheme
    + + + + @@ -3960,132 +4611,155 @@ instead + + + + + + + + + + + + + + + + + + + + + + + @@ -4097,36 +4771,42 @@ instead +

    Column Configuration Options

    +
    DeprecatedWhat to use instead
    compareitem compare
    indexitem id
    numcolumnscolumn count
    numitemsitem count
    rangeitem range
    + + + + @@ -4135,84 +4815,98 @@ instead + + + + + + + + + + + + @@ -4220,42 +4914,49 @@ name + + + + + + + @@ -4263,6 +4964,7 @@ Changed + @@ -4270,24 +4972,28 @@ it changed + + + + @@ -4296,216 +5002,253 @@ for valid state names. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -4517,36 +5260,42 @@ for valid state names. +

    Column Command

    +
    RemovedWhat to use instead
    -relief
    +     		-state
    -sunken-state
    Renamed
    +     		New name
    -arrowpad-arrowpadx
    Usage ChangedHow it changed
    -backgroundThis is now a per-state option. See COLUMNS in the help file for valid state names.
    New
    +
    -arrowbitmap
    +
    -arrowimage
    -arrowpady
    -maxwidth
    -resize
    -state
    -textlines
    + + + + @@ -4555,42 +5304,49 @@ instead + + + + + + + @@ -4598,6 +5354,7 @@ Changed + @@ -4605,30 +5362,35 @@ changed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -4903,36 +5709,42 @@ index in the list of columns. +

    Item Command

    +
    DeprecatedWhat to use instead
    column indexcolumn id
    Arguments/Result ChangedWhat changed
    column configure
    +     		A column description of "all" is allowed if at least one option-value pair is given.
    @@ -4637,30 +5399,35 @@ option-value pair is given.
    +
    column createThe result is a unique identifier. Previously the result was an @@ -4670,228 +5437,267 @@ index in the list of columns.
    column deleteA column description of "all" is allowed.
    NewComment
    column compare
    column countreplaces "numcolumns"
    column dragconfigure
    column dragcget
    column idreplaces "column index"
    column list
    column order
    + + + + @@ -4941,180 +5753,211 @@ instead + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -5126,30 +5969,35 @@ instead +

    Notify Command

    +
    RemovedWhat to use instead
    item indexitem order
    NewComment
    item comparereplaces "compare"
    item countreplaces "numitems"
    item idreplaces "index"
    item orderreplaces "item index"
    item rangereplaces "range"
    + + + @@ -5157,6 +6005,7 @@ Changed + @@ -5164,30 +6013,35 @@ changed + + + + @@ -5195,30 +6049,36 @@ argument + + + + + + @@ -5239,12 +6101,15 @@ argument + New syntax:
    + + @@ -5255,6 +6120,8 @@ New syntax:
    + + @@ -5265,36 +6132,43 @@ New syntax:
    + + + + + + + + + @@ -5395,12 +6285,15 @@ above + + + @@ -5412,30 +6305,35 @@ above +

    Style Layout Options

    +
    Arguments/Result ChangedWhat changed
    notify generate
    +     		Added optional percentsCommand argument
    notify installOld syntax (supported but deprecated):
    + + @@ -5229,6 +6089,8 @@ argument
    notify linkageOld syntax (supported but deprecated):
    + + @@ -5304,12 +6178,15 @@ New syntax:
    + 
    notify linkage eventName
    + + @@ -5320,18 +6197,22 @@ New syntax:
    + + New syntax:
    + + @@ -5341,12 +6222,15 @@ New syntax:
    + 
    notify linkage <eventName>
    + + @@ -5357,36 +6241,42 @@ New syntax:
    + +
    notify uninstallsee notify install above
    + + + @@ -5443,6 +6341,7 @@ Changed + @@ -5450,24 +6349,28 @@ it changed + + + + @@ -5534,210 +6447,246 @@ surrounds. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -5749,18 +6698,21 @@ surrounds. +

    Element Changes

    + +

    Event Changes

    + +

    Library Script Changes

    +

    filelist-bindings.tcl:

    + +

    treectrl.tcl:

    + +

    Other Changes

    + +

    Demo Changes

    + + diff --git a/doc/treectrl.html b/doc/treectrl.html index 363c52a..d384f4b 100644 --- a/doc/treectrl.html +++ b/doc/treectrl.html @@ -1,10 +1,10 @@ -treectrl - Tk Commands - @@ -2710,6 +2710,13 @@ Specifies whether the element should be positioned by itself, i.e. independent from the other elements.

    +
    -draw boolean
    +This is a per-state option that determines whether +an element should be drawn. If the value of the option evaluates to false for a given +item state, then the element is not drawn, although it still consumes space in +the layout. + +

    -expand flags
    This option allows the external padding around the element to increase when a style has more screen space than it needs. @@ -3426,6 +3433,7 @@ the bitmap to display in the element.

    -draw boolean
    +Deprecated; use the style layout option -draw instead. Specifies as a per-state option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -3452,6 +3460,7 @@ element will not be drawn.

    -draw boolean
    +Deprecated; use the style layout option -draw instead. Specifies as a per-state option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -3497,6 +3506,7 @@ The following options are supported for image elements:
    -draw boolean
    +Deprecated; use the style layout option -draw instead. Specifies as a per-state option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -3528,6 +3538,7 @@ The following options are supported for rectangle elements:
    -draw boolean
    +Deprecated; use the style layout option -draw instead. Specifies as a per-state option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -3592,6 +3603,7 @@ The following options are supported for text elements:
    -draw boolean
    +Deprecated; use the style layout option -draw instead. Specifies as a per-state option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -3717,6 +3729,7 @@ will not be destroyed.

    -draw boolean
    +Deprecated; use the style layout option -draw instead. Specifies as a per-state option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. diff --git a/doc/treectrl.man b/doc/treectrl.man index 4e696f7..d0ca240 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.47 2006/12/04 20:55:19 treectrl Exp $} + $Id: treectrl.man,v 1.48 2006/12/07 03:56:42 treectrl Exp $} ][manpage_begin treectrl n 2.2] [moddesc {Tk Commands}] [titledesc {Create and manipulate hierarchical multicolumn widgets}] @@ -2051,6 +2051,12 @@ The following options are supported: Specifies whether the element should be positioned by itself, i.e. independent from the other elements. +[opt_def [option -draw] [arg boolean]] +This is a [sectref {PER-STATE OPTIONS} per-state] option that determines whether +an element should be drawn. If the value of the option evaluates to false for a given +item state, then the element is not drawn, although it still consumes space in +the layout. + [opt_def [option -expand] [arg flags]] This option allows the external padding around the element to increase when a style has more screen space than it needs. @@ -2677,6 +2683,7 @@ Specifies as a [sectref {PER-STATE OPTIONS} per-state] option the bitmap to display in the element. [opt_def [option -draw] [arg boolean]] +Deprecated; use the style layout option [option -draw] instead. Specifies as a [sectref {PER-STATE OPTIONS} per-state] option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -2700,6 +2707,7 @@ If the value for a certain state is an empty string (the default), the element will not be drawn. [opt_def [option -draw] [arg boolean]] +Deprecated; use the style layout option [option -draw] instead. Specifies as a [sectref {PER-STATE OPTIONS} per-state] option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -2739,6 +2747,7 @@ The following options are supported for image elements: [list_begin opt] [opt_def [option -draw] [arg boolean]] +Deprecated; use the style layout option [option -draw] instead. Specifies as a [sectref {PER-STATE OPTIONS} per-state] option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -2766,6 +2775,7 @@ The following options are supported for rectangle elements: [list_begin opt] [opt_def [option -draw] [arg boolean]] +Deprecated; use the style layout option [option -draw] instead. Specifies as a [sectref {PER-STATE OPTIONS} per-state] option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -2822,6 +2832,7 @@ The following options are supported for text elements: [list_begin opt] [opt_def [option -draw] [arg boolean]] +Deprecated; use the style layout option [option -draw] instead. Specifies as a [sectref {PER-STATE OPTIONS} per-state] option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -2932,6 +2943,7 @@ is unspecified (the default), it is treated as false and the Tk window will not be destroyed. [opt_def [option -draw] [arg boolean]] +Deprecated; use the style layout option [option -draw] instead. Specifies as a [sectref {PER-STATE OPTIONS} per-state] option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. diff --git a/doc/treectrl.n b/doc/treectrl.n index 4426f89..76405c6 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.63 2006/12/04 20:55:19 treectrl Exp $ +'\" $Id: treectrl.n,v 1.64 2006/12/07 03:56:42 treectrl Exp $ .so man.macros .TH "treectrl" n 2.2 treectrl "Tk Commands" .BS @@ -2600,6 +2600,12 @@ The following options are supported: Specifies whether the element should be positioned by itself, i.e. independent from the other elements. .TP +\fB\fB-draw\fR\fR \fIboolean\fR +This is a \fBper-state\fR option that determines whether +an element should be drawn. If the value of the option evaluates to false for a given +item state, then the element is not drawn, although it still consumes space in +the layout. +.TP \fB\fB-expand\fR\fR \fIflags\fR This option allows the external padding around the element to increase when a style has more screen space than it needs. @@ -3207,6 +3213,7 @@ Specifies as a \fBper-state\fR option the bitmap to display in the element. .TP \fB\fB-draw\fR\fR \fIboolean\fR +Deprecated; use the style layout option \fB-draw\fR instead. Specifies as a \fBper-state\fR option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -3227,6 +3234,7 @@ If the value for a certain state is an empty string (the default), the element will not be drawn. .TP \fB\fB-draw\fR\fR \fIboolean\fR +Deprecated; use the style layout option \fB-draw\fR instead. Specifies as a \fBper-state\fR option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -3261,6 +3269,7 @@ An element of type \fBimage\fR can be used to display an image in an item. The following options are supported for image elements: .TP \fB\fB-draw\fR\fR \fIboolean\fR +Deprecated; use the style layout option \fB-draw\fR instead. Specifies as a \fBper-state\fR option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -3283,6 +3292,7 @@ An element of type \fBrect\fR can be used to display a rectangle in an item. The following options are supported for rectangle elements: .TP \fB\fB-draw\fR\fR \fIboolean\fR +Deprecated; use the style layout option \fB-draw\fR instead. Specifies as a \fBper-state\fR option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -3335,6 +3345,7 @@ An element of type \fBtext\fR can be used to display a text in an item. The following options are supported for text elements: .TP \fB\fB-draw\fR\fR \fIboolean\fR +Deprecated; use the style layout option \fB-draw\fR instead. Specifies as a \fBper-state\fR option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. @@ -3441,6 +3452,7 @@ is unspecified (the default), it is treated as false and the Tk window will not be destroyed. .TP \fB\fB-draw\fR\fR \fIboolean\fR +Deprecated; use the style layout option \fB-draw\fR instead. Specifies as a \fBper-state\fR option whether to draw the element. If the value for a certain state is an empty string (the default), it is treated as true and the element will be drawn. -- cgit v0.12
    Usage ChangedHow it changed
    -iexpandTwo new flags "x' and "y" are allowed. Previously, only the -ipadx and -ipady padding could be expanded by this option. The new xy @@ -5478,6 +6381,8 @@ update your code, you will probably want to change this:
    + + @@ -5487,24 +6392,29 @@ update your code, you will probably want to change this:
    + 
    $T style layout $S $E -iexpand we
    + + to this:
    + + @@ -5514,18 +6424,21 @@ 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