## Tcl8.6.17/Tk8.6.17 Documentation > Tk Commands > ttk_treeview

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    ttk::treeview — 階層別の多列データ表示部品 　hierarchical multicolumn data display widget
  構文 SYNOPSIS
  説明 DESCRIPTION
  STANDARD OPTIONS
    -class, undefined, undefined
    -cursor, cursor, Cursor
    -padding, padding, Padding
    -style, style, Style
    -takefocus, takeFocus, TakeFocus
    -xscrollcommand, xScrollCommand, ScrollCommand
    -yscrollcommand, yScrollCommand, ScrollCommand
  部品固有の指示項目 WIDGET-SPECIFIC OPTIONS
    -columns, columns, Columns
    -displaycolumns, displayColumns, DisplayColumns
    -height, height, Height
    -selectmode, selectMode, SelectMode
    -show, show, Show
      tree
      headings
  部品命令 WIDGET COMMAND
    pathname bbox item ?column?
    pathname cget option
    pathname children item ?newchildren?
    pathname column column ?-option ?value -option value...?
      -id name
      -anchor anchor
      -minwidth minwidth
      -stretch boolean
      -width width
    pathname configure ?option? ?value option value ...?
    pathname delete itemList
    pathname detach itemList
    pathname exists item
    pathname focus ?item?
    pathname heading column ?-option ?value -option value...?
      -text text
      -image imageName
      -anchor anchor
      -command script
    pathname identify component x y
      pathname identify region x y
        heading
        separator
        tree
        cell
      pathname identify column x y
      pathname identify element x y
      pathname identify row x y
    pathname index item
    pathname insert parent index ?-id id? options...
    pathname instate statespec ?script?
    pathname item item ?-option ?value -option value...?
    pathname move item parent index
    pathname next item
    pathname parent item
    pathname prev item
    pathname see item
    pathname selection ?selop itemList?
      pathname selection set itemList
      pathname selection add itemList
      pathname selection remove itemList
      pathname selection toggle itemList
    pathname set item ?column? ?value?
    pathname state ?stateSpec?
    pathName tag args...
      pathName tag bind tagName ?sequence? ?script?
      pathName tag configure tagName ?option? ?value option value...?
      pathName tag has tagName ?item?
      pathName tag names
      pathName tag add tag items
      pathName tag remove tag ?items?
  ITEM OPTIONS
    -text, text, Text
    -image, image, Image
    -values, values, Values
    -open, open, Open
    -tags, tags, Tags
  TAG OPTIONS
    -foreground
    -background
    -font
    -image
  COLUMN IDENTIFIERS
  假想行事 VIRTUAL EVENTS
    <<TreeviewSelect>>
    <<TreeviewOpen>>
    <<TreeviewClose>>
  様式の指示項目STYLING OPTIONS
  SEE ALSO

### NAME

ttk::treeview — 階層別の多列データ表示部品 　hierarchical multicolumn data display widget

### 構文 SYNOPSIS

ttk::treeview pathname ?options?

### 説明 DESCRIPTION

ttk::treeview 部品は品目の階層構造の集合を表示する｡それぞれの品目は文書的札と､追加的な影像と､追加的なデータ値のリストを有する｡データの値は樹枝状札の後の連続した列に表示される｡ 　　 The ttk::treeview 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.

データの値が表示される順序は -displaycolumns 部品指示項目の設定によって制御され得る｡この樹枝状部品は列の先頭をも表示可能である｡列は番号又は -columns 部品指示項目内に列挙されている象徴的名称で利用できる; COLUMN IDENTIFIERS を参照されたい｡ 　　　 The order in which data values are displayed may be controlled by setting the -displaycolumns widget option. The tree widget can also display column headings. Columns may be accessed by number or by symbolic names listed in the -columns widget option; see COLUMN IDENTIFIERS.

それぞれの品目は重複しない名前で識別される｡その部品は呼出し側が用意しない場合は識別番号 ID を作成する｡重要な根本品目があり､名前は {} である｡根本品目自身は表示されない; その子供は階層構造の頂上水準として現れる｡ 　　 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 {}. The root item itself is not displayed; its children appear at the top level of the hierarchy.

それぞれの品目は貼り札のリストを有する､それは行事束縛と個別品目の結合と､品目の外観の制御に使用可能である｡ 　　 Each item also has a list of tags, which can be used to associate event bindings with individual items and control the appearance of the item.

樹枝表示部品は標準の -[xy]scrollcommand 指示項目と [xy]view 部品命令によって水平と垂直の摺動を運営している｡ 　　 Treeview widgets support horizontal and vertical scrolling with the standard -[xy]scrollcommand options and [xy]view widget commands.

### STANDARD OPTIONS

-class, undefined, undefined
-cursor, cursor, Cursor
-padding, padding, Padding
-style, style, Style
-takefocus, takeFocus, TakeFocus
-xscrollcommand, xScrollCommand, ScrollCommand
-yscrollcommand, yScrollCommand, ScrollCommand

### 部品固有の指示項目 WIDGET-SPECIFIC OPTIONS

Command-Line Name: -columns
Database Name: columns
Database Class: Columns
  列の識別子のリスト､列の番号とその名前を指定する｡ 　　　 A list of column identifiers, specifying the number of columns and their names.

Command-Line Name: -displaycolumns
Database Name: displayColumns
Database Class: DisplayColumns
  表示されるデータ列と､現れる順序を指定している(表象する名前か整数番号かどちらかでの)列の識別子のリストであるか､或は､文字列 #all である｡もし #all (省略時設定)が指定されると､全ての列が与えられた順に表示される｡ 　　 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 #all. If set to #all (the default), all columns are shown in the order given.

Command-Line Name: -height
Database Name: height
Database Class: Height
  可視であるべき行の数を指定する｡註意： 要求される巾は列巾の合計から定められる｡ Specifies the number of rows which should be visible. Note: the requested width is determined from the sum of the column widths.

Command-Line Name: -selectmode
Database Name: selectMode
Database Class: SelectMode
  組込みの級束縛が選択を如何に管理するかを制御する｡ extended か browse か none の内の一つ｡ 　　 Controls how the built-in class bindings manage the selection. One of extended, browse, or none.

  もし extended (省略時設定)に設定すると､複数の品目が選択される｡もし browse の場合同時には一つの品目のみ選択される｡もし none の場合､選択は変更されない｡ 　　 If set to extended (the default), multiple items may be selected. If browse, only a single item will be selected at a time. If none, the selection will not be changed.

  註意すべきは､応用譜の命令譜と貼り札束縛は -selectmode の値に関係なく､望む時に選択を設定できる｡ 　　　 Note that application code and tag bindings can set the selection however they wish, regardless of the value of -selectmode.

Command-Line Name: -show
Database Name: show
Database Class: Show
  次の値を零又は幾つかを含むリストであって樹枝のどの要素を表示するかを指定する｡ 　　 A list containing zero or more of the following values, specifying which elements of the tree to display.

  tree
    列 #0 に樹枝札を表示する｡ 　　 Display tree labels in column #0.

  headings
    先頭の行を表示する｡ 　　 Display the heading row.

  省略時設定は tree headings であり即ち全ての要素を表示する｡ 　　 The default is tree headings, i.e., show all elements.

  註意: -show tree が指定されてなくとも､列 #0 は常に樹枝列を参照する｡ NOTE: Column #0 always refers to the tree column, even if -show tree is not specified.

### 部品命令 WIDGET COMMAND

pathname bbox item ?column?
  指定された(樹枝図版の部品の窓に関連する) item の境界領域を x y 幅 高さ の形式で返す｡もし column が指定されると､その欄の境界領域を返す｡もし item が可視でない場合(即ち､閉じられた品目の子孫であるか､摺動による画面外の場合)は空文字列を返す｡もし要素が部分的に可視の場合､結果は見えない部分を含む要素の全領域を与える｡ 　　 Returns the bounding box (relative to the treeview widget's window) of the specified item in the form x y width height. If column is specified, returns the bounding box of that cell. If the item is not visible (i.e., if it is a descendant of a closed item or is scrolled offscreen), returns the empty list. If the element is partially visible, the result gives the full area of the element, including any parts that are not visible.

pathname cget option
  Returns the current value of the specified option; see ttk::widget(n).

pathname children item ?newchildren?
  If newchildren is not specified, returns the list of children belonging to item.

  もし newchildren が指定される場合､ item の子供のリストを newchildren に置き換える｡古い子供のリスト内の品目の内､新しい子供のリストに存在しないものは樹枝から取除かれる｡ newchildren 内のどの品目も新しい item の祖先にはならない｡ 　　 If newchildren is specified, replaces item's child list with newchildren. Items in the old child list not present in the new child list are detached from the tree. None of the items in newchildren may be an ancestor of item.

pathname column column ?-option ?value -option value...?
  column で指定された指示項目を問合せ又は修正する｡もし -option が指定されないと､指示項目/値 対の辞書を返す｡一つの -option が指定される場合､その指示項目の値が返る｡それ以外の場合､品目の指示項目が指定された値に更新される｡次の指示項目がそれぞれの列に設定され得る: 　　 Query or modify the options for the specified column. If no -option is specified, returns a dictionary of option/value pairs. If a single -option 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:

  -id name
    列の名前｡これは読出し専用指示項目である｡譬えば､ [$pathname column #n-id] は､表示された列 #n に連結したデータ列を返す｡ 　　 The column name. This is a read-only option. For example, [$pathname column #n -id] returns the data column associated with display column #n.

  -anchor anchor
    列内の文書を欄に関して如何に整列するかを指定する｡anchor は n か ne か e か se か s か sw か w か nw か center のどれか｡ 　　 Specifies how the text in this column should be aligned with respect to the cell. Anchor is one of n, ne, e, se, s, sw, w, nw, or center.

  -minwidth minwidth
    画素単位の列の最小幅｡樹枝図版の部品は､部品の寸法変更や使用者の列区切りの引っ張りの時に -minwidth より小さい列を作らない｡省略時設定は20 画素｡ The minimum width of the column in pixels. The treeview widget will not make the column any smaller than -minwidth when the widget is resized or the user drags a column separator. Default is 20 pixels.

  -stretch boolean
    部品が寸法変更されたり､使用者が列区切りを曳き摺った時に､列幅が調整されるか否かを指定する｡論理値は Tcl_GetBoolean により受容れられるどれかの形式を有する｡省略時設定では列は引伸ばし可能である｡ Specifies whether or not the column width should be adjusted when the widget is resized or the user drags a column separator. Boolean may have any of the forms accepted by Tcl_GetBoolean. By default columns are stretchable.

  -width width
    画素単位の列の幅｡省略時設定は 200 ｡指定された列巾は､ -stretch 及び/又は -minwidth を考慮する為､又は､部品が寸法変更されるか､使用者が列区切を曳摺る時に､ Tk により変更される｡ The width of the column in pixels. Default is 200 pixels. The specified column width may be changed by Tk in order to honor -stretch and/or -minwidth, or when the widget is resized or the user drags a column separator.

  樹枝列を構成設定する為には pathname column #0 を使れたい｡ 　　 Use pathname column #0 to configure the tree column.

pathname configure ?option? ?value option value ...?
  部品の指示項目を修正又は問合せする; ttk::widget(n) を参照されたい｡ 　 Modify or query widget options; see ttk::widget(n).

pathname delete itemList
  itemList 内のそれぞれの品目とその全ての子孫を削除する｡根本の品目は削除されない｡ detach を参照のこと｡ 　　 Deletes each of the items in itemList and all of their descendants. The root item may not be deleted. See also: detach.

pathname detach itemList
  itemList 内の全ての指定された品目を樹枝から連結を断つ｡品目とその全ての子孫は依然として存在し､ move 操作により樹枝内の他の位置に再挿入されるかもしれないが､そうなる迄は表示されない｡根本の品目は引離されない｡ delete を参照のこと｡ 　　 Unlinks all of the specified items in itemList from the tree. The items and all of their descendants are still present and may be reinserted at another point in the tree with the move operation, but will not be displayed until that is done. The root item may not be detached. See also: delete.

pathname exists item
  指定された item が樹枝内に存在する場合は 1 を返す､それ以外は 0 を返す｡ 　 Returns 1 if the specified item is present in the tree, 0 otherwise.

pathname focus ?item?
  もし item が指定される場合､注目の品目を item に設定する｡それ以外の場合､現在の品目を返すか､ない場合は {} を返す｡ 　　 If item is specified, sets the focus item to item. Otherwise, returns the current focus item, or {} if there is none.

pathname heading column ?-option ?value -option value...?
  column によって指定された題目の指示項目の問合せと修正を行う｡適正な指示項目は以下の通り: 　　　 Query or modify the heading options for the specified column. Valid options are:

  -text text
    列の題目内に表示する文書｡ 　　 The text to display in the column heading.

  -image imageName
    列の題目の右に表示する影像を指定する｡ 　　 Specifies an image to display to the right of the column heading.

  -anchor anchor
    列の題目の文書を如何に整列するかを指定する｡標準 Tk 錨値の内の一つ｡ 　　 Specifies how the heading text should be aligned. One of the standard Tk anchor values.

  -command script
    題目の札が押された時に評価する記述譜｡ 　　 A script to evaluate when the heading label is pressed.

  樹枝列の題目を構成設定する為には pathname heading #0 を使れたい｡ 　　 Use pathname heading #0 to configure the tree column heading.

pathname identify component x y
  位置 x, y にある component により指定された記述を返す､そのような component がそこにない場合空文字列を返す｡値 x と y は Tk_GetPixels に受容れられるどの様な形式でも好い｡次の副命令が運営されている: 　　 Returns a description of the specified component under the point given by x and y, or the empty string if no such component is present at that position. The values x and y may have any of the forms acceptable to Tk_GetPixels. The following subcommands are supported:

  pathname identify region x y
      次の内の一つを返す: 　 Returns one of:

      heading
        樹枝題目領域; 題目の番号を定める為には [pathname identify column x y] を使れたい｡ 　 Tree heading area; use [pathname identify column x y] to determine the heading number.

      separator
        二つの列の題目の間の空間; [pathname identify column x y] が区切りの左に着いた題目の表示列の識別子を返す｡ 　　 Space between two column headings; [pathname identify column x y] will return the display column identifier of the heading to left of the separator.

      tree
        樹枝領域｡ 　　 The tree area.

      cell
        データの欄｡ 　 A data cell.

    pathname identify item x y 位置 y にある品目の品目識別子を返す｡　　　　 Returns the item ID of the item at position y.

  pathname identify column x y
    位置 x にある列の表示された列識別子を返す｡樹枝列は識別子 #0 を有する｡　　 Returns the display column identifier of the cell at position x. The tree column has ID #0.

  pathname identify element x y
    位置 x,y にある要素｡ 　　 The element at position x,y.

  pathname identify row x y
    pathname identify item に就いての廃れた構文｡ 　 Obsolescent synonym for pathname identify item.

  表示列とデータ列の論議については COLUMN IDENTIFIERS を参照されたい｡ 　　 See COLUMN IDENTIFIERS for a discussion of display columns and data columns.

pathname index item
  その親が持つ子供のリスト内の item の整数番号を返す｡ 　 Returns the integer index of item within its parent's list of children.

pathname insert parent index ?-id id? options...
  新しい品目を作成する｡ parent は親の品目の識別子であるか､新しい頂上水準の品目を作成する場合は {} である｡ index は整数であるか､値 end であり､新しい品目を parent の持つ子供のリストに挿入する位置を指定する｡もし index が零かそれより小さい場合､新しい接合部は先頭に挿入する､もし index が現在の子供の数と同じかより大きいと末尾に挿入する｡もし -id が指定されると､品目の識別子として扱われる; id は樹枝内に既に存在していてはならない｡それ以外の場合､新しく重複しない識別子が生成される｡ Creates a new item. parent is the item ID of the parent item, or the empty string {} to create a new top-level item. index is an integer, or the value end, specifying where in the list of parent's children to insert the new item. If index is less than or equal to zero, the new node is inserted at the beginning; if index is greater than or equal to the current number of children, it is inserted at the end. If -id is specified, it is used as the item identifier; id must not already exist in the tree. Otherwise, a new unique identifier is generated.

  pathname insert は新しく生成された品目の識別子を返す｡利用できる指示項目のリストについては ITEM OPTIONS を参照されたい｡ pathname insert returns the item identifier of the newly created item. See ITEM OPTIONS for the list of available options.

pathname instate statespec ?script?
  部品の状態を試験する; ttk::widget(n) を参照されたい｡ 　 Test the widget state; see ttk::widget(n).

pathname item item ?-option ?value -option value...?
  item で指定された指示項目を問合せ又は修正する｡もし -option が指定されないと､指示項目/値 対の辞書を返す｡一つの -option が指定される場合､その指示項目の値が返る｡それ以外の場合､品目の指示項目が指定された値に更新される｡利用できる指示項目のリストについては ITEM OPTIONS を参照されたい｡ 　　 Query or modify the options for the specified item. If no -option is specified, returns a dictionary of option/value pairs. If a single -option is specified, returns the value of that option. Otherwise, the item's options are updated with the specified values. See ITEM OPTIONS for the list of available options.

pathname move item parent index
  index を parent の子供のリストの index の位置に移動する｡品目をその子孫の内の一つの下の順に移動することは不適切である｡ 　　 Moves item to position index in parent's list of children. It is illegal to move an item under one of its descendants.

  もし index が零かそれより小さい場合､ item は先頭に移動する､もし子供の数と同じかより大きいと末尾に移動する｡ 　　 If index is less than or equal to zero, item is moved to the beginning; if greater than or equal to the number of children, it is moved to the end.

pathname next item
  item の直ぐ下の弟の識別子を返す､ item が親の最後の子供の場合は {} を返す｡ 　　 Returns the identifier of item's next sibling, or {} if item is the last child of its parent.

pathname parent item
  item の親の識別子を返す､ item が階層構造の頂上水準の場合は {} を返す｡ 　 Returns the ID of the parent of item, or {} if item is at the top level of the hierarchy.

pathname prev item
  item の直ぐ上の兄の識別子を返す､ item が親の最初の子供の場合は {} を返す｡ 　 Returns the identifier of item's previous sibling, or {} if item is the first child of its parent.

pathname see item
  item を確実に可視にする: item の全ての先祖を -open true に設定し､且つ､必要に応じて item が樹枝の可視部位内になるように部品を摺動する｡ 　 Ensure that item is visible: sets all of item's ancestors to -open true, and scrolls the widget if necessary so that item is within the visible portion of the tree.

pathname selection ?selop itemList?
  もし selop が指定されていない場合､選択された要素のリストを返す｡それ以外は selop は次の内の１つである: 　　　 If selop is not specified, returns the list of selected items. Otherwise, selop is one of the following:

  pathname selection set itemList
    itemList は新しい選択になる｡ itemList becomes the new selection.

  pathname selection add itemList
    itemList を選択に追加する｡ 　　 Add itemList to the selection

  pathname selection remove itemList
    itemList を選択から削除する｡ 　　 Remove itemList from the selection

  pathname selection toggle itemList
    itemList 内のそれぞれの選択の状態を巡回往復する｡ 　　 Toggle the selection state of each item in itemList.

pathname set item ?column? ?value?
  引数が１つの場合指定された item に関する 列/値 対の辞書を返す｡引数が二つの場合､指定された column の現在の値を返す｡引数が３つの場合､品目 item 内の列 column の値を指定された value に設定する｡ COLUMN IDENTIFIERS を参照されたい｡ With one argument, returns a dictionary of column/value pairs for the specified item. With two arguments, returns the current value of the specified column. With three arguments, sets the value of column column in item item to the specified value. See also COLUMN IDENTIFIERS.

pathname state ?stateSpec?
  部品の状態を修正又は問合せする; ttk::widget(n) を参照されたい｡ 　 Modify or query the widget state; see ttk::widget(n).

pathName tag args...

  pathName tag bind tagName ?sequence? ?script?
    Tk 束縛記述譜を､引続く行事の sequence の為に､貼り札 tagName に加える｡ X 行事は品目､に配付され､それぞれの品目の -tags の為の束縛記述譜は順番に bindtags(n) を通して評価される｡ 　　 Add a Tk binding script for the event sequence sequence to the tag tagName. When an X event is delivered to an item, binding scripts for each of the item's -tags are evaluated in order as per bindtags(n).

    <KeyPress> と <KeyRelease>と仮想行事は注目の品目に送られる｡ <ButtonPress> と <ButtonRelease> と <Motion> 行事はマウス指示子の下に送られる｡他の行事の型は運営されていない｡ <KeyPress>, <KeyRelease>, and virtual events are sent to the focus item. <ButtonPress>, <ButtonRelease>, and <Motion> events are sent to the item under the mouse pointer. No other event types are supported.

    束縛 script は評価される前に百分率置換が遂行される; 詳細は bind(n) を参照されたい｡ 　 The binding script undergoes %-substitutions before evaluation; see bind(n) for details.

  pathName tag configure tagName ?option? ?value option value...?
    指定された tagName の為の指示項目を問合せ又は修正する｡もし一つ以上の option/value 対が指定されると､指定された貼り札のためのその指示項目の値を設定する｡もし一つの option が指定される場合､その指示項目の値を返す(又は tagName の為の指示項目が指定されない場合空文字列を)｡追加的引数がない場合､ tagName の為に設定した辞書を返す｡利用できる指示項目のリストについては TAG OPTIONS を参照されたい｡ 　　　 Query or modify the options for the specified tagName. If one or more option/value pairs are specified, sets the value of those options for the specified tag. If a single option is specified, returns the value of that option (or the empty string if the option has not been specified for tagName). With no additional arguments, returns a dictionary of the option settings for tagName. See TAG OPTIONS for the list of available options.

  pathName tag has tagName ?item?
    もし item が指定されている場合､品目が名前のついた貼り札の有無に依存して 1 か 0 を返す｡それ以外の場合､指定された貼り札を有する全ての品目のリストを返す｡ 　　 If item is specified, returns 1 or 0 depending on whether the specified item has the named tag. Otherwise, returns a list of all items which have the specified tag.

  pathName tag names
    部品に使用されている全ての貼り札のリストを返す｡ 　　 Returns a list of all tags used by the widget.

  pathName tag add tag items
    指定された tag をそれぞれの列挙された item に加える｡もし tag が既に特定の品目の為に存在する場合､その品目の為の -tags は変化しない｡ 　　 Adds the specified tag to each of the listed items. If tag is already present for a particular item, then the -tags for that item are unchanged.

  pathName tag remove tag ?items?
    指定された tag をそれぞれの列挙された items から除去する｡もし items が省略されると､ tag を樹枝内のそれぞれの品目から除去する｡もし tag が特定の品目の為に存在しない場合､その品目の為の -tags は変化しない｡ 　　 Removes the specified tag from each of the listed items. If items is omitted, removes tag from each item in the tree. If tag is not present for a particular item, then the -tags for that item are unchanged.

treeview 部品は次の一般的 ttk::widget 部品副命令も運営している(詳細は ttk::widget(n)(n) を参照されたい)： The treeview widget also supports the following generic ttk::widget widget subcommands (see ttk::widget(n) for details):

  xview | yview

### ITEM OPTIONS

次の品目の指示項目が insert と item 部品命令内の品目の為に指定されるかもしれない｡ 　　 The following item options may be specified for items in the insert and item widget commands.

Command-Line Name: -text
Database Name: text
Database Class: Text
  品目表示の為の文書の札｡ 　　 The textual label to display for the item.

Command-Line Name: -image
Database Name: image
Database Class: Image
  札の左側に表示される Tk 影像｡ 　　 A Tk image, displayed to the left of the label.

Command-Line Name: -values
Database Name: values
Database Class: Values
  品目に結合した値のリスト｡ 　　 The list of values associated with the item.

  それぞれの品目は -columns 部品指示項目と同じ数の値を有するべき｡もし､列より値が小さい場合､残りの値は空と仮定される｡もし列より値が大きい場合余分な値は無視される｡ 　　　 Each item should have the same number of values as the -columns 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.

Command-Line Name: -open
Database Name: open
Database Class: Open
  品目の子供が表示されるか(-open true)隠蔽されるか(-open false)を指し示す論理値｡ 　　 A boolean value indicating whether the item's children should be displayed (-open true) or hidden (-open false).

Command-Line Name: -tags
Database Name: tags
Database Class: Tags
  この品目に結合した貼り札｡ 　　 A list of tags associated with this item.

### TAG OPTIONS

次の指示項目が貼り札上に指定されるかもしれない: 　　 The following options may be specified on tags:

-foreground
  文書の前景色を指定する｡ 　　 Specifies the text foreground color.

-background
  小部屋又は品目の背景色を指定する｡ 　　 Specifies the cell or item background color.

-font
  文書を描く時に使う文字形状の指定｡ 　　 Specifies the font to use when drawing text.

-image
  品目の -image 指示項目が空の場合､品目の影像を指定する｡ 　　 Specifies the item image, in case the item's -image option is empty.

優先順位は創生順により定まる： 最初に創生された舌がより高い優先順位を受取る｡ Tag priority is decided by the creation order: tags created first receive higher priority.

### COLUMN IDENTIFIERS

列識別子は次のどれかの形式を取る: 　　 Column identifiers take any of the following forms:

- -columns のリストから象徴的な名前｡ 　　 A symbolic name from the list of -columns.

- 整数 nであり､ n 番目のデータ列を指定する｡ 　 An integer n, specifying the nth data column.

- #n の形式の文字列､ここで n は整数であって､ n 番目の表示列を指定する｡ 　 A string of the form #n, where n is an integer, specifying the nth display column.

註意: 品目 -values は保存されている順序と異なる順序で表示されるかもしれない｡ NOTE: Item -values may be displayed in a different order than the order in which they are stored.

註意: -show tree が指定されていなくとも､列 #0 は常に樹枝列を参照する｡ NOTE: Column #0 always refers to the tree column, even if -show tree is not specified.

data column number は品目の -values リストに入れる番号である; display column number は値が表示されている樹枝内の列番号である｡樹枝札は #0 列に表示される｡もし -displaycolumns が設定されていない場合､データ番号 n が列 #n+1 内に表示される｡再度念を押すが､列 #0 は常に樹枝列を参照する｡ 　　 A data column number is an index into an item's -values list; a display column number is the column number in the tree where the values are displayed. Tree labels are displayed in column #0. If -displaycolumns is not set, then data column n is displayed in display column #n+1. Again, column #0 always refers to the tree column.

### 假想行事 VIRTUAL EVENTS

樹枝図版部品は次の假想行事を生成する｡ 　　 The treeview widget generates the following virtual events.

<<TreeviewSelect>>
  何時であれ選択が変更された時に生成される｡又､選択が影響を受けるが実際には変更されない時にも生成され得る｡更には､多重の選択の変更は同じ可視の選択による多重行事に至る行事が進行し得る前に起こり得る｡ Generated whenever the selection changes. It might also be generated when selection is affected but not actually changed. Further, multiple selection changes could happen before events can be processed leading to multiple events with the same visible selection.

<<TreeviewOpen>>
  注目の品目を -open true に設定する直前に生成される｡ 　　 Generated just before setting the focus item to -open true.

<<TreeviewClose>>
  注目の品目を -open false に設定した直後に生成される｡ 　　 Generated just after setting the focus item to -open false.

影響された品目を定めるために focus と selection 部品命令が使用できる｡ 　　 The focus and selection widget commands can be used to determine the affected item or items.

### 様式の指示項目STYLING OPTIONS

ttk::treeview の級の名前は Treeview である｡ treeview header の級の名前は Heading である｡ treeview item の級の名前は Item である｡ treeview cell の級の名前は Cell である｡　　　　　　　　 The class name for a ttk::treeview is Treeview. The treeview header class name is Heading. The treeview item class name is Item. The treeview cell class name is Cell.

Dynamic states: disabled, selected.

ttk::style を使って構成設定可能な Treeview 様式指示項目は以下の通り： Treeview styling options configurable with ttk::style are:

-background color
-fieldbackground color
-font font
-foreground color
-indent amount

  その親から幾つの画素品目が字下げされるかを指定する｡無為設定は 20｡値は Tk_GetPixels に受容れられるどの様な形式でも好い｡ Specifies how far items are indented from their parents. Defaults to 20 pixels. The value may have any of the forms acceptable to Tk_GetPixels.

-rowheight amount

  これは､この品目の標準高さ｡無為設定は 20 画素｡値は Tk_GetPixels に受容れられるどの様な形式でも好い｡ -rowheight が様式によって定められてない場合､様式の設定に伴う品目と区画の位置取りによって設定される｡そこで､これは､主題の配置から､字母とどの様な焦点環も拾い上げ､詰込む｡-rowheight が設定されるには､列がどの影像を容れるにも充分な大きさであることを確実にすることが必要かもしれない｡[訳註:譯がハチャメチャ……] This is the standard height for an item. Defaults to 20 pixels. The value may have any of the forms acceptable to Tk_GetPixels. If -rowheight is not set by the style, it is set by measuring an item and a cell layout with the style's settings. This thus picks up the font and any focus ring or padding from the theme's layout. The -rowheight may need to be set to make sure that a row is large enough to contain any images.

  樹枝状視野の様式の為に -rowheight を調整する為に､tk scaling が適用された後ろの次の命令符号を使うべし｡注意すべきは､喩え算譜の中に tk scaling を適用したり変更したりしなくても､その算譜の使用者が .wishrc の中でそれを設定させるかもしれない｡ To adjust the -rowheight for the Treeview style, use the following code after tk scaling has been applied. Note that even if you do not support or change tk scaling in your program, your users may have it set in their .wishrc.

    ttk::style configure Treeview \
         -rowheight [expr {[font metrics font -linespace] + 2}]

ttk::style を使って構成設定可能な Heading 様式指示項目は以下の通り： Heading styling options configurable with ttk::style are:

-background color
-font font
-relief relief

ttk::style を使って構成設定可能な item 様式指示項目は以下の通り： Item styling options configurable with ttk::style are:

-foreground color
-indicatormargins padding
-indicatorsize amount
-padding padding

ttk::style を使って構成設定可能な cell 様式指示項目は以下の通り： Cell styling options configurable with ttk::style are:

-padding padding

幾つかの指示項目は特別の主題の為にのみ利用できる｡　　　　 Some options are only available for specific themes.

ttk 様式を如何に構成設定するかの情報は ttk::style の取扱い説明書頁を参照されたい｡　　　　　 See the ttk::style manual page for information on how to configure ttk styles.

### SEE ALSO

ttk::widget, listbox, image, bind
Copyright © 2004 Joe English