summaryrefslogtreecommitdiffstats
path: root/doc/ttk_treeview.n
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ttk_treeview.n')
-rw-r--r--doc/ttk_treeview.n461
1 files changed, 232 insertions, 229 deletions
diff --git a/doc/ttk_treeview.n b/doc/ttk_treeview.n
index f80b458..f724fe7 100644
--- a/doc/ttk_treeview.n
+++ b/doc/ttk_treeview.n
@@ -3,9 +3,9 @@
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
-'\"
-'\" RCS: @(#) $Id: ttk_treeview.n,v 1.5 2007/05/03 23:55:30 dkf Exp $
-'\"
+'\"
+'\" RCS: @(#) $Id: ttk_treeview.n,v 1.6 2007/10/22 14:33:13 dkf Exp $
+'\"
.so man.macros
.TH ttk_treeview n 8.5 Tk "Tk Themed Widget"
.\" Use _ instead of :: as the name becomes a filename on install
@@ -17,33 +17,28 @@ ttk_treeview \- hierarchical multicolumn data display widget
.SH DESCRIPTION
The \fBttk::treeview\fR widget displays a hierarchical collection of items.
-Each item has a textual label, an optional image,
-and an optional list of data values.
-The data values are displayed in successive columns after
-the tree label.
+Each item has a textual label, an optional image, and an optional list of data
+values. The data values are displayed in successive columns after the tree
+label.
.PP
-The order in which data values are displayed may be controlled
-by setting the \fB-displaycolumns\fR widget option.
-The tree widget can also display column headings.
-Columns may be accessed by number or by symbolic names
-listed in the \fB-columns\fR widget option;
-see \fBCOLUMN IDENTIFIERS\fR.
+The order in which data values are displayed may be controlled by setting the
+\fB\-displaycolumns\fR widget option. The tree widget can also display column
+headings. Columns may be accessed by number or by symbolic names listed in the
+\fB\-columns\fR widget option; see \fBCOLUMN IDENTIFIERS\fR.
.PP
-Each item is identified by a unique name.
-The widget will generate item IDs if they are not supplied by the caller.
-There is a distinguished root item, named \fB{}\fR.
-The root item itself is not displayed;
-its children appear at the top level of the hierarchy.
+Each item is identified by a unique name. The widget will generate item IDs if
+they are not supplied by the caller. There is a distinguished root item, named
+\fB{}\fR. The root item itself is not displayed; its children appear at the
+top level of the hierarchy.
.PP
-Each item also has a list of \fItags\fR,
-which can be used to associate event bindings with individual items
-and control the appearance of the item.
+Each item also has a list of \fItags\fR, which can be used to associate event
+bindings with individual items and control the appearance of the item.
.\" .PP
.\" @@@HERE: describe selection, focus item
.PP
-Treeview widgets support horizontal and vertical scrolling with the
-standard \fB-[xy]scrollcommand\fR options
-and \fB[xyview\fR widget commands.
+Treeview widgets support horizontal and vertical scrolling with the standard
+\fB\-\fR[\fBxy\fR]\fBscrollcommand\fR options and \fB[xyview\fR widget
+commands.
.SO
\-class \-cursor \-takefocus \-style
\-xscrollcommand \-yscrollcommand
@@ -51,306 +46,320 @@ and \fB[xyview\fR widget commands.
.SH "WIDGET-SPECIFIC OPTIONS"
.OP \-columns columns Columns
-A list of column identifiers,
-specifying the number of columns and their names.
+A list of column identifiers, specifying the number of columns and their
+names.
.\"X: This is a read-only option; it may only be set when the widget is created.
.OP \-displaycolumns displayColumns DisplayColumns
-A list of column identifiers
-(either symbolic names or integer indices)
-specifying which data columns are displayed
-and the order in which they appear,
-or the string \fB#all\fP.
+A list of column identifiers (either symbolic names or integer indices)
+specifying which data columns are displayed and the order in which they
+appear, or the string \fB#all\fP.
.br
If set to \fB#all\fP (the default), all columns are shown in the order given.
.OP \-height height Height
-Specifies the number of rows which should be visible.
-Note:
-the requested width is determined from the sum of the column widths.
+Specifies the number of rows which should be visible. Note: the requested
+width is determined from the sum of the column widths.
.OP \-padding padding Padding
-Specifies the internal padding for the widget.
-The padding is a list of up to four length specifications;
-see \fBTtk_GetPaddingFromObj()\fR for details.
+Specifies the internal padding for the widget. The padding is a list of up to
+four length specifications; see \fBTtk_GetPaddingFromObj()\fR for details.
.OP \-selectmode selectMode SelectMode
-Controls how the built-in class bindings manage the selection.
-One of \fBextended\fR, \fBbrowse\fR, or \fBnone\fR.
+Controls how the built-in class bindings manage the selection. One of
+\fBextended\fR, \fBbrowse\fR, or \fBnone\fR.
.br
-If set to \fBextended\fR (the default), multiple items may be selected.
-If \fBbrowse\fR, only a single item will be selected at a time.
-If \fBnone\fR, the selection will not be changed.
+If set to \fBextended\fR (the default), multiple items may be selected. If
+\fBbrowse\fR, only a single item will be selected at a time. If \fBnone\fR,
+the selection will not be changed.
.br
-Note that application code and tag bindings can set the selection
-however they wish, regardless of the value of \fB-selectmode\fR.
+Note that application code and tag bindings can set the selection however they
+wish, regardless of the value of \fB\-selectmode\fR.
.OP \-show show Show
-A list containing zero or more of the following values, specifying
-which elements of the tree to display.
+A list containing zero or more of the following values, specifying which
+elements of the tree to display.
.RS
.IP \fBtree\fR
-Display tree labels in column #0.
+Display tree labels in column #0.
.IP \fBheadings\fR
Display the heading row.
.PP
The default is \fBtree headings\fR, i.e., show all elements.
.PP
-\fBNOTE:\fR Column #0 always refers to the tree column,
-even if \fB-show tree\fR is not specified.
+\fBNOTE:\fR Column #0 always refers to the tree column, even if \fB\-show
+tree\fR is not specified.
.RE
.SH "WIDGET COMMAND"
.TP
\fIpathname \fBbbox\fR \fIitem\fR ?\fIcolumn\fR?
-Returns the bounding box (relative to the treeview widget's window)
-of the specified \fIitem\fR
-in the form \fIx y width height\fR.
-If \fIcolumn\fR is specified, returns the bounding box of that cell.
-If the \fIitem\fR is not visible
-(i.e., if it is a descendant of a closed item or is scrolled offscreen),
-returns the empty list.
+.
+Returns the bounding box (relative to the treeview widget's window) of the
+specified \fIitem\fR in the form \fIx y width height\fR. If \fIcolumn\fR is
+specified, returns the bounding box of that cell. If the \fIitem\fR is not
+visible (i.e., if it is a descendant of a closed item or is scrolled
+offscreen), returns the empty list.
.TP
\fIpathname \fBcget\fR \fIoption\fR
-Returns the current value of the specified \fIoption\fR; see \fIttk_widget(n)\fR.
+.
+Returns the current value of the specified \fIoption\fR; see
+\fIttk_widget(n)\fR.
.TP
\fIpathname \fBchildren\fR \fIitem\fR ?\fInewchildren\fR?
-If \fInewchildren\fR is not specified,
-returns the list of children belonging to \fIitem\fR.
+.
+If \fInewchildren\fR is not specified, returns the list of children belonging
+to \fIitem\fR.
.br
-If \fInewchildren\fR is specified, replaces \fIitem\fR's child list
-with \fInewchildren\fR.
-Items in the old child list not present in the new child list
-are detached from the tree.
-None of the items in \fInewchildren\fR may be an ancestor
-of \fIitem\fR.
-.TP
-\fIpathname \fBcolumn\fR \fIcolumn\fR ?\fI-option \fR?\fIvalue -option value...\fR?
-Query or modify the options for the specified \fIcolumn\fR.
-If no \fI-option\fR is specified,
-returns a dictionary of option/value pairs.
-If a single \fI-option\fR is specified,
-returns the value of that option.
-Otherwise, the options are updated with the specified values.
-The following options may be set on each column:
+If \fInewchildren\fR is specified, replaces \fIitem\fR's child list with
+\fInewchildren\fR. Items in the old child list not present in the new child
+list are detached from the tree. None of the items in \fInewchildren\fR may be
+an ancestor of \fIitem\fR.
+.TP
+\fIpathname \fBcolumn\fR \fIcolumn\fR ?\fI\-option \fR?\fIvalue \-option value...\fR?
+.
+Query or modify the options for the specified \fIcolumn\fR. If no
+\fI\-option\fR is specified, returns a dictionary of option/value pairs. If a
+single \fI\-option\fR is specified, returns the value of that option.
+Otherwise, the options are updated with the specified values. The following
+options may be set on each column:
.RS
.TP
-\fB-id \fIname\fR
-The column name. This is a read-only option.
-For example, [\fI$pathname \fBcolumn #\fIn \fB-id\fR]
-returns the data column associated with data column #\fIn\fR.
-.TP
-\fB-anchor\fR
-Specifies how the text in this column should be aligned
-with respect to the cell. One of
-\fBn\fR, \fBne\fR, \fBe\fR, \fBse\fR,
-\fBs\fR, \fBsw\fR, \fBw\fR, \fBnw\fR, or \fBcenter\fR.
-.TP
-\fB-minwidth\fR
-The minimum width of the column in pixels.
-The treeview widget will not make the column any smaller than
-\fB-minwidth\fR when the widget is resized or the user drags a
-column separator.
-.TP
-\fB-stretch\fR
-Specifies whether or not the column's width should be adjusted
-when the widget is resized.
-.TP
-\fB-width \fIw\fR
-The width of the column in pixels. Default is something reasonable,
-probably 200 or so.
+\fB\-id \fIname\fR
+.
+The column name. This is a read-only option. For example, [\fI$pathname
+\fBcolumn #\fIn \fB\-id\fR] returns the data column associated with data
+column #\fIn\fR.
+.TP
+\fB\-anchor\fR
+.
+Specifies how the text in this column should be aligned with respect to the
+cell. One of \fBn\fR, \fBne\fR, \fBe\fR, \fBse\fR, \fBs\fR, \fBsw\fR, \fBw\fR,
+\fBnw\fR, or \fBcenter\fR.
+.TP
+\fB\-minwidth\fR
+.
+The minimum width of the column in pixels. The treeview widget will not make
+the column any smaller than \fB\-minwidth\fR when the widget is resized or the
+user drags a column separator.
+.TP
+\fB\-stretch\fR
+.
+Specifies whether or not the column's width should be adjusted when the widget
+is resized.
+.TP
+\fB\-width \fIw\fR
+.
+The width of the column in pixels. Default is something reasonable, probably
+200 or so.
.PP
Use \fIpathname column #0\fR to configure the tree column.
.RE
.TP
\fIpathname \fBconfigure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?
+.
Modify or query widget options; see \fIttk_widget(n)\fR.
.TP
\fIpathname \fBdelete\fR \fIitemList\fR
-Deletes each of the items in \fIitemList\fR and all of their descendants.
-The root item may not be deleted.
-See also: \fBdetach\fR.
+.
+Deletes each of the items in \fIitemList\fR and all of their descendants. The
+root item may not be deleted. See also: \fBdetach\fR.
.TP
\fIpathname \fBdetach\fR \fIitemList\fR
-Unlinks all of the specified items in \fIitemList\fR from the tree.
-The items and all of their descendants are still present
-and may be reinserted at another point in the tree
-but will not be displayed.
-The root item may not be detached.
-See also: \fBdelete\fR.
+.
+Unlinks all of the specified items in \fIitemList\fR from the tree. The items
+and all of their descendants are still present and may be reinserted at
+another point in the tree but will not be displayed. The root item may not be
+detached. See also: \fBdelete\fR.
.TP
\fIpathname \fBexists \fIitem\fR
-Returns 1 if the specified \fIitem\fR is present in the tree,
-0 otherwise.
+.
+Returns 1 if the specified \fIitem\fR is present in the tree, 0 otherwise.
.TP
\fIpathname \fBfocus \fR?\fIitem\fR?
-If \fIitem\fR is specified, sets the focus item to \fIitem\fR.
-Otherwise, returns the current focus item, or \fB{}\fR if there is none.
+.
+If \fIitem\fR is specified, sets the focus item to \fIitem\fR. Otherwise,
+returns the current focus item, or \fB{}\fR if there is none.
.\" Need: way to clear the focus item. {} works for this...
-.TP
-\fIpathname \fBheading\fR \fIcolumn\fR ?\fI-option \fR?\fIvalue -option value...\fR?
-Query or modify the heading options for the specified \fIcolumn\fR.
-Valid options are:
+.TP
+\fIpathname \fBheading\fR \fIcolumn\fR ?\fI\-option \fR?\fIvalue \-option value...\fR?
+.
+Query or modify the heading options for the specified \fIcolumn\fR. Valid
+options are:
.RS
.TP
-\fB-text \fItext\fR
+\fB\-text \fItext\fR
+.
The text to display in the column heading.
.TP
-\fB-image \fIimageName\fR
+\fB\-image \fIimageName\fR
+.
Specifies an image to display to the right of the column heading.
.TP
-\fB-anchor \fIanchor\fR
-Specifies how the heading text should be aligned.
-One of the standard Tk anchor values.
+\fB\-anchor \fIanchor\fR
+.
+Specifies how the heading text should be aligned. One of the standard Tk
+anchor values.
.TP
-\fB-command \fIscript\fR
+\fB\-command \fIscript\fR
+.
A script to evaluate when the heading label is pressed.
.PP
Use \fIpathname heading #0\fR to configure the tree column heading.
.RE
.TP
\fIpathname \fBidentify \fIcomponent x y\fR
-Returns a description of the specified \fIcomponent\fR
-under the point given by \fIx\fR and \fIy\fR,
-or the empty string if no such \fIcomponent\fR is present at that position.
-The following subcommands are supported:
+.
+Returns a description of the specified \fIcomponent\fR under the point given
+by \fIx\fR and \fIy\fR, or the empty string if no such \fIcomponent\fR is
+present at that position. The following subcommands are supported:
.RS
.TP
\fIpathname \fBidentify row\fR \fIx y\fR
+.
Returns the item ID of the item at position \fIy\fR.
.TP
\fIpathname \fBidentify column\fR \fIx y\fR
-Returns the data column identifier of the cell at position \fIx\fR.
-The tree column has ID \fB#0\fR.
+.
+Returns the data column identifier of the cell at position \fIx\fR. The tree
+column has ID \fB#0\fR.
.PP
-See \fBCOLUMN IDENTIFIERS\fR for a discussion of display columns
-and data columns.
+See \fBCOLUMN IDENTIFIERS\fR for a discussion of display columns and data
+columns.
.RE
.TP
\fIpathname \fBindex \fIitem\fR
+.
Returns the integer index of \fIitem\fR within its parent's list of children.
.TP
-\fIpathname \fBinsert\fR \fIparent\fR \fIindex\fR ?\fB-id \fIid\fR? \fIoptions...\fR
-Creates a new item.
-\fIparent\fR is the item ID of the parent item,
-or the empty string \fB{}\fR
-to create a new top-level item.
-\fIindex\fR is an integer, or the value \fBend\fR, specifying where in the
-list of \fIparent\fR's children to insert the new item.
-If \fIindex\fR is less than or equal to zero,
-the new node is inserted at the beginning;
-if \fIindex\fR is greater than or equal to the current number of children,
-it is inserted at the end.
-If \fB-id\fR is specified, it is used as the item identifier;
-\fIid\fR must not already exist in the tree.
-Otherwise, a new unique identifier is generated.
+\fIpathname \fBinsert\fR \fIparent\fR \fIindex\fR ?\fB\-id \fIid\fR? \fIoptions...\fR
+.
+Creates a new item. \fIparent\fR is the item ID of the parent item, or the
+empty string \fB{}\fR to create a new top-level item. \fIindex\fR is an
+integer, or the value \fBend\fR, specifying where in the list of
+\fIparent\fR's children to insert the new item. If \fIindex\fR is less than or
+equal to zero, the new node is inserted at the beginning; if \fIindex\fR is
+greater than or equal to the current number of children, it is inserted at the
+end. If \fB\-id\fR is specified, it is used as the item identifier; \fIid\fR
+must not already exist in the tree. Otherwise, a new unique identifier is
+generated.
.br
-\fIpathname \fBinsert\fR returns the item identifier of the
-newly created item.
-See \fBITEM OPTIONS\fR for the list of available options.
+\fIpathname \fBinsert\fR returns the item identifier of the newly created
+item. See \fBITEM OPTIONS\fR for the list of available options.
.TP
\fIpathname \fBinstate \fIstatespec\fR ?\fIscript\fR?
+.
Test the widget state; see \fIttk_widget(n)\fR.
.TP
-\fIpathname \fBitem\fR \fIitem\fR ?\fI-option \fR?\fIvalue -option value...\fR?
-Query or modify the options for the specified \fIitem\fR.
-If no \fI-option\fR is specified,
-returns a dictionary of option/value pairs.
-If a single \fI-option\fR is specified,
-returns the value of that option.
-Otherwise, the item's options are updated with the specified values.
-See \fBITEM OPTIONS\fR for the list of available options.
+\fIpathname \fBitem\fR \fIitem\fR ?\fI\-option \fR?\fIvalue \-option value...\fR?
+.
+Query or modify the options for the specified \fIitem\fR. If no \fI\-option\fR
+is specified, returns a dictionary of option/value pairs. If a single
+\fI\-option\fR is specified, returns the value of that option. Otherwise, the
+item's options are updated with the specified values. See \fBITEM OPTIONS\fR
+for the list of available options.
.TP
\fIpathname \fBmove \fIitem parent index\fR
+.
Moves \fIitem\fR to position \fIindex\fR in \fIparent\fR's list of children.
It is illegal to move an item under one of its descendants.
.br
-If \fIindex\fR is less than or equal to zero, \fIitem\fR is moved
-to the beginning; if greater than or equal to the number of children,
-it's moved to the end.
-.TP
+If \fIindex\fR is less than or equal to zero, \fIitem\fR is moved to the
+beginning; if greater than or equal to the number of children, it's moved to
+the end.
+.TP
\fIpathname \fBnext \fIitem\fR
-Returns the identifier of \fIitem\fR's next sibling,
-or \fB{}\fR if \fIitem\fR is the last child of its parent.
+.
+Returns the identifier of \fIitem\fR's next sibling, or \fB{}\fR if \fIitem\fR
+is the last child of its parent.
.TP
\fIpathname \fBparent \fIitem\fR
-Returns the ID of the parent of \fIitem\fR,
-or \fB{}\fR if \fIitem\fR is at the top level of the hierarchy.
-.TP
+.
+Returns the ID of the parent of \fIitem\fR, or \fB{}\fR if \fIitem\fR is at
+the top level of the hierarchy.
+.TP
\fIpathname \fBprev \fIitem\fR
-Returns the identifier of \fIitem\fR's previous sibling,
-or \fB{}\fR if \fIitem\fR is the first child of its parent.
+.
+Returns the identifier of \fIitem\fR's previous sibling, or \fB{}\fR if
+\fIitem\fR is the first child of its parent.
.TP
\fIpathname \fBsee\fR \fIitem\fR
-Ensure that \fIitem\fR is visible:
-sets all of \fIitem\fR's ancestors to \fB-open true\fR,
-and scrolls the widget if necessary so that \fIitem\fR is
+.
+Ensure that \fIitem\fR is visible: sets all of \fIitem\fR's ancestors to
+\fB\-open true\fR, and scrolls the widget if necessary so that \fIitem\fR is
within the visible portion of the tree.
.TP
\fIpathname \fBselection\fR ?\fIselop\fR \fIitemList\fR?
+.
If \fIselop\fR is not specified, returns the list of selected items.
Otherwise, \fIselop\fR is one of the following:
.RS
.TP
\fIpathname \fBselection set \fIitemList\fR
+.
\fIitemList\fR becomes the new selection.
.TP
\fIpathname \fBselection add \fIitemList\fR
+.
Add \fIitemList\fR to the selection
.TP
\fIpathname \fBselection remove \fIitemList\fR
+.
Remove \fIitemList\fR from the selection
.TP
\fIpathname \fBselection toggle \fIitemList\fR
+.
Toggle the selection state of each item in \fIitemList\fR.
.RE
.TP
\fIpathname \fBset\fR \fIitem\fR ?\fIcolumn\fR ?\fIvalue\fR??
-With one argument, returns a dictionary of column/value pairs
-for the specified \fIitem\fR.
-With two arguments, returns the current value of the specified \fIcolumn\fR.
-With three arguments, sets the value of column \fIcolumn\fR
-in item \fIitem\fR to the specified \fIvalue\fR.
-See also \fBCOLUMN IDENTIFIERS\fR.
+.
+With one argument, returns a dictionary of column/value pairs for the
+specified \fIitem\fR. With two arguments, returns the current value of the
+specified \fIcolumn\fR. With three arguments, sets the value of column
+\fIcolumn\fR in item \fIitem\fR to the specified \fIvalue\fR. See also
+\fBCOLUMN IDENTIFIERS\fR.
.TP
\fIpathname \fBstate\fR ?\fIstateSpec\fR?
+.
Modify or query the widget state; see \fIttk_widget(n)\fR.
.TP
\fIpathName \fBtag \fIargs...\fR
+.
.RS
.TP
\fIpathName \fBtag bind \fItagName \fR?\fIsequence \fR?\fIscript\fR??
-Add a Tk binding script for the event sequence \fIsequence\fR
-to the tag \fItagName\fR. When an X event is delivered to an item,
-binding scripts for each of the item's \fB-tags\fR are evaluated
-in order as per \fIbindtags(n)\fR.
+.
+Add a Tk binding script for the event sequence \fIsequence\fR to the tag
+\fItagName\fR. When an X event is delivered to an item, binding scripts for
+each of the item's \fB\-tags\fR are evaluated in order as per
+\fIbindtags(n)\fR.
.br
-\fB<KeyPress>\fR, \fB<KeyRelease>\fR, and virtual events
-are sent to the focus item.
-\fB<ButtonPress>\fR, \fB<ButtonRelease>\fR, and \fB<Motion>\fR events
-are sent to the item under the mouse pointer.
-No other event types are supported.
+\fB<KeyPress>\fR, \fB<KeyRelease>\fR, and virtual events are sent to the focus
+item. \fB<ButtonPress>\fR, \fB<ButtonRelease>\fR, and \fB<Motion>\fR events
+are sent to the item under the mouse pointer. No other event types are
+supported.
.br
-The binding \fIscript\fR undergoes \fB%\fR-substitutions before
-evaluation; see \fBbind(n)\fR for details.
+The binding \fIscript\fR undergoes \fB%\fR-substitutions before evaluation;
+see \fBbind(n)\fR for details.
.TP
\fIpathName \fBtag configure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?
-Query or modify the options for the specified \fItagName\fR.
-If one or more \fIoption/value\fR pairs are specified,
-sets the value of those options for the specified tag.
-If a single \fIoption\fR is specified,
-returns the value of that option
-(or the empty string if the option has not been specified for \fItagName\fR).
-With no additional arguments,
-returns a dictionary of the option settings for \fItagName\fR.
-See \fBTAG OPTIONS\fR for the list of available options.
+.
+Query or modify the options for the specified \fItagName\fR. If one or more
+\fIoption/value\fR pairs are specified, sets the value of those options for
+the specified tag. If a single \fIoption\fR is specified, returns the value of
+that option (or the empty string if the option has not been specified for
+\fItagName\fR). With no additional arguments, returns a dictionary of the
+option settings for \fItagName\fR. See \fBTAG OPTIONS\fR for the list of
+available options.
.RE
.TP
\fIpathName \fBxview \fIargs\fR
+.
Standard command for horizontal scrolling; see \fIwidget(n)\fR.
.TP
\fIpathName \fByview \fIargs\fR
+.
Standard command for vertical scrolling; see \fIttk_widget(n)\fR.
-
.PP
.SH "ITEM OPTIONS"
-The following item options may be specified for items
-in the \fBinsert\fR and \fBitem\fR widget commands.
+The following item options may be specified for items in the \fBinsert\fR and
+\fBitem\fR widget commands.
.OP \-text text Text
The textual label to display for the item.
.OP \-image image Image
@@ -358,17 +367,15 @@ A Tk image, displayed to the left of the label.
.OP \-values values Values
The list of values associated with the item.
.br
-Each item should have the same number of values as
-the \fB-columns\fR widget option.
-If there are fewer values than columns,
-the remaining values are assumed empty.
-If there are more values than columns,
-the extra values are ignored.
+Each item should have the same number of values as the \fB\-columns\fR widget
+option. If there are fewer values than columns, the remaining values are
+assumed empty. If there are more values than columns, the extra values are
+ignored.
.OP \-open open Open
-A boolean value indicating whether the item's children
-should be displayed (\fB-open true\fR) or hidden (\fB-open false\fR).
+A boolean value indicating whether the item's children should be displayed
+(\fB\-open true\fR) or hidden (\fB\-open false\fR).
.OP \-tags tags Tags
-A list of tags associated with this item.
+A list of tags associated with this item.
.SH "TAG OPTIONS"
The following options may be specified on tags:
.IP \-foreground
@@ -381,47 +388,43 @@ Specifies the font to use when drawing text.
.\" ??? Maybe: .IP \-padding
.\" ??? Maybe: .IP \-text
.IP \-image
-Specifies the item image, in case the item's \fB-image\fR option is empty.
+Specifies the item image, in case the item's \fB\-image\fR option is empty.
.PP
\fI(@@@ TODO: sort out order of precedence for options)\fR
-
.SH "COLUMN IDENTIFIERS"
Column identifiers take any of the following forms:
.IP \(bu
-A symbolic name from the list of \fB-columns\fR.
+A symbolic name from the list of \fB\-columns\fR.
.IP \(bu
An integer \fIn\fR, specifying the \fIn\fRth data column.
.IP \(bu
-A string of the form \fB#\fIn\fR, where \fIn\fR is an integer,
-specifying the \fIn\fRth display column.
+A string of the form \fB#\fIn\fR, where \fIn\fR is an integer, specifying the
+\fIn\fRth display column.
.PP
-\fBNOTE:\fR
-Item \fB-values\fR may be displayed in a different order than
-the order in which they are stored.
+\fBNOTE:\fR Item \fB\-values\fR may be displayed in a different order than the
+order in which they are stored.
.PP
-\fBNOTE:\fR Column #0 always refers to the tree column,
-even if \fB-show tree\fR is not specified.
+\fBNOTE:\fR Column #0 always refers to the tree column, even if \fB\-show
+tree\fR is not specified.
.PP
-A \fIdata column number\fR is an index into an item's \fB-values\fR list;
-a \fIdisplay column number\fR is the column number in the tree
-where the values are displayed.
-Tree labels are displayed in column #0.
-If \fB-displaycolumns\fR is not set,
-then data column \fIn\fR is displayed in display column \fB#\fIn+1\fR.
-Again, \fBcolumn #0 always refers to the tree column\fR.
+A \fIdata column number\fR is an index into an item's \fB\-values\fR list; a
+\fIdisplay column number\fR is the column number in the tree where the values
+are displayed. Tree labels are displayed in column #0. If
+\fB\-displaycolumns\fR is not set, then data column \fIn\fR is displayed in
+display column \fB#\fIn+1\fR. Again, \fBcolumn #0 always refers to the tree
+column\fR.
.SH "VIRTUAL EVENTS"
The treeview widget generates the following virtual events.
.IP <<TreeviewSelect>>
Generated whenever the selection changes.
.IP <<TreeviewOpen>>
-Generated just before setting the focus item to \fB-open true\fR.
+Generated just before setting the focus item to \fB\-open true\fR.
.IP <<TreeviewClose>>
-Generated just after setting the focus item to \fB-open false\fR.
+Generated just after setting the focus item to \fB\-open false\fR.
.PP
-The \fBfocus\fR and \fBselection\fR widget commands can be used
-to determine the affected item or items.
-In Tk 8.5, the affected item is also passed as the \fB-detail\fR field
-of the virtual event.
+The \fBfocus\fR and \fBselection\fR widget commands can be used to determine
+the affected item or items. In Tk 8.5, the affected item is also passed as the
+\fB\-detail\fR field of the virtual event.
.SH "SEE ALSO"
ttk_widget(n), listbox(n), image(n), bind(n)