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.n506
1 files changed, 246 insertions, 260 deletions
diff --git a/doc/ttk_treeview.n b/doc/ttk_treeview.n
index 475ed40..142e113 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.8 2007/10/24 14:32:59 dkf Exp $
-'\"
+'\"
+'\" RCS: @(#) $Id: ttk_treeview.n,v 1.9 2007/10/26 20:13:23 dgp 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,377 +17,358 @@ 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\-\fR[\fBxy\fR]\fBscrollcommand\fR options and \fB[xyview\fR widget
-commands.
+Treeview widgets support horizontal and vertical scrolling with the
+standard \fB-[xy]scrollcommand\fR options
+and \fB[xyview\fR widget commands.
.SO
-\-class \-cursor \-takefocus
-\-style \-xscrollcommand \-yscrollcommand
+\-class \-cursor \-takefocus \-style
+\-xscrollcommand \-yscrollcommand
.SE
+
.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.
-.RS
-.PP
+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.
-.RE
.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.
-.RS
-.PP
-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.
-.PP
-Note that application code and tag bindings can set the selection however they
-wish, regardless of the value of \fB\-selectmode\fR.
-.RE
+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.
+.br
+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.
-.RS
-.PP
-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.
-.RE
-.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 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:
.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.
-.RS
-.PP
-\fIpathname \fBinsert\fR returns the item identifier of the newly created
-item. See \fBITEM OPTIONS\fR for the list of available options.
-.RE
+\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.
.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.
-.RS
-.PP
-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.
-.RE
-.TP
+.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
\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.
-.RS
-.PP
-\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.
-.PP
-The binding \fIscript\fR undergoes \fB%\fR-substitutions before evaluation;
-see \fBbind(n)\fR for details.
-.RE
+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.
+.br
+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
A Tk image, displayed to the left of the label.
.OP \-values values Values
The list of values associated with the item.
-.RS
-.PP
-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.
-.RE
+.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.
.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
@@ -400,42 +381,47 @@ 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 \fB<<TreeviewSelect>>\fR
+.IP <<TreeviewSelect>>
Generated whenever the selection changes.
-.IP \fB<<TreeviewOpen>>\fR
-Generated just before setting the focus item to \fB\-open true\fR.
-.IP \fB<<TreeviewClose>>\fR
-Generated just after setting the focus item to \fB\-open false\fR.
+.IP <<TreeviewOpen>>
+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.
.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)