diff options
Diffstat (limited to 'doc/ttk_treeview.n')
| -rw-r--r-- | doc/ttk_treeview.n | 461 |
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) |