## Tcl9.0.3/Tk9.0.3 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
    -selecttype, selectType, SelectType
    -show, show, Show
      tree
      headings
    -striped, striped, Striped
    -titlecolumns, titleColumns, TitleColumns
    -titleitems, titleItems, TitleItems
  WIDGET COMMAND
    pathname bbox item ?column?
    pathname cellselection ?selop arg ...?
      pathname cellselection set cellList
      pathname cellselection set firstCell lastCell
      pathname cellselection add cellList
      pathname cellselection add firstCell lastCell
      pathname cellselection remove cellList
      pathname cellselection remove firstCell lastCell
      pathname cellselection toggle cellList
      pathname cellselection toggle firstCell lastCell
    pathname children item ?newchildren?
    pathname column column ?-option ?value -option value...?
      -id name
      -anchor anchor
      -minwidth minwidth
      -separator boolean
      -stretch boolean
      -width width
    pathname delete itemList
    pathname detach itemList
    pathname detached ?item?
    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 item x y
      pathname identify column x y
      pathname identify cell x y
      pathname identify element x y
      pathname identify row x y
    pathname index item
    pathname insert parent index ?-id id? options...
    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 tag args...
      pathName tag add tag items
      pathName tag bind tagName ?sequence? ?script?
      pathName tag cell subcommand...
        pathName tag cell add tag cellList
        pathName tag cell has tagName ?cell?
        pathName tag cell remove tag ?cellList?
      pathName tag configure tagName ?option? ?value option value...?
      pathName tag delete tagName
      pathName tag has tagName ?item?
      pathName tag names
      pathName tag remove tag ?items?
  ITEM OPTIONS
    -text
    -height
    -image
    -imageanchor
    -values
    -hidden
    -open
    -tags
  TAG OPTIONS
    -foreground
    -background
    -font
    -image
    -imageanchor
    -padding
    -stripedbackground
  IMAGES
  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 that 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: -selecttype
Database Name: selectType
Database Class: SelectType
  組込みの級束縛が選択を如何に管理するかを制御する｡ item か cell の内の一つ｡ 　　 Controls how the built-in class bindings manage the selection. One of item or cell.

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.

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

Command-Line Name: -striped
Database Name: striped
Database Class: Striped
  縞模様の品目の色付けを指定する論理値｡ 註意すべきは､縞状の品目は､主題や貼札によって設定される場合は､ -stripedbackground指示項目を使う｡ もし､現在の主題が対応してない場合は､表示されない｡ Boolean specifying zebra striped item coloring. Note that striped items uses the -stripedbackground option if set by the theme or a tag. If not supported by the current theme, it will not show.

Command-Line Name: -titlecolumns
Database Name: titleColumns
Database Class: TitleColumns
  左側に､表示され､巻上げられない､列の数｡ 縦え-show treeが指定されなくとも､樹枝状列は､勘定する｡ 従って､この指示項目の為の値 N は列 #N が巻上げ可能の最初のものになる｡ 無為設定は0である｡ Number of display columns at the left that should not be scrolled. The tree column counts, even if -show tree is not specified. Thus for value N of this option, column #N is the first one that is scrollable. Default is 0.

Command-Line Name: -titleitems
Database Name: titleItems
Database Class: TitleItems
  縦方向に巻上げられない頂上の品目の数｡無為設定は0である｡　 Number of items at the top that should not be vertically scrolled. Default is 0.

### WIDGET COMMAND

treeview部品は､ 標準の cget と configure と instate と state と style と xview と yview 命令(ttk::widget参照)に追加して 次の命令に対応する: In addition to the standard cget, configure, instate, state, style, xview and yview commands (see ttk::widget), treeview widgets support the following additional commands:

pathname bbox item ?column?
  指定された束縛箱(樹枝表示部品の窓への相対方向)を､ x y width heightの形式で返す｡ もし､itemが可視でない場合､ (即ち､閉じた品目の子孫とか､画面外に巻上げられた)空リストを返す｡ もし､列columnが指定され､ 且つ､(-displaycolumns指示項目によって)隠蔽でない場合､ 品目内部のセルの束縛箱を返す (縦え､セルが水平に画面外に巻上げられていても)｡ Returns the bounding box (relative to the treeview widget's window) of the specified item in the form x y width height. If the item is not visible (i.e., if it is a descendant of a closed item or is vertically scrolled offscreen), returns the empty list. If column is specified and is not hidden (by the -displaycolumns option), returns the bounding box of that cell within item (even if the cell is horizontally scrolled offscreen).

pathname cellselection ?selop arg ...?
  セル選択を管理する｡ セル選択はselection命令によって扱われる品目選択とは独立である｡ セルは､品目と列の二つの要素のリストによって与えられる｡ 命令の矩形の版に関して､セルは､表示された列内になければならない｡ -columns へのどの様な変更も､セル選択を解消する｡ cellList引数は､単一のセルでも､セルのリストであってもよい｡ もし､selopが指定されないと､選択されたセルを返す｡ それ以外では､selopは次の内の一つである: Manages cell selection. Cell selection is independent from item selection handled by the selection command. A cell is given by a list of two elements, item and column. For the rectangle versions of commands, the cells must be in displayed columns. Any change to -columns clears the cell selection. A cellList argument may be a single cell or a list of cells. If selop is not specified, returns the list of selected cells. Otherwise, selop is one of the following:

  pathname cellselection set cellList
    cellList が新しいセル選択になる｡ cellList becomes the new cell selection.

  pathname cellselection set firstCell lastCell
    定義された矩形が新しいセル選択になる｡ The rectangle defined becomes the new cell selection.

  pathname cellselection add cellList
    セル選択にcellListを追加する｡ Add cellList to the cell selection.

  pathname cellselection add firstCell lastCell
    定義された矩形はセル選択に追加される｡ The rectangle defined is added to the cell selection.

  pathname cellselection remove cellList
    セル選択からセルのリストcellListを削除する｡ Remove cellList from the cell selection.

  pathname cellselection remove firstCell lastCell
    定義された矩形はセル選択から削除される｡ The rectangle defined is removed from the cell selection.

  pathname cellselection toggle cellList
    cellList内のそれぞれのセルに関するセル選択状態を交互交替する｡ もし､要素が部分的に可視であると､ 結果は､ 不可視のどの部分をも含む､ 要素の全領域を与える｡ Toggle the cell selection state of each cell in cellList. If the element is partially visible, the result gives the full area of the element, including any parts that are not visible.

  pathname cellselection toggle firstCell lastCell
    定義された矩形内のそれぞれのセルに関するセル選択状態 を交互交替する｡ Toggle the cell selection state of each cell in the rectangle defined.

pathname children item ?newchildren?
  もし､新しい子供newchildrenが指定されないと､品目itemに属する 子供のリストを返す｡ 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 に連結したデータ列を返す｡ 樹枝列は-id #0を有す｡ 　　 The column name. This is a read-only option. For example, [$pathname column #n -id] returns the data column associated with display column n. The tree column has -id #0.

  -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 heading column separator. Default is 20 pixels.

  -separator boolean
    列区切りが列の右に描かれるか否かを指定する｡無為設定は偽値｡ Specifies whether or not a column separator should be drawn to the right of the column. Default is false.

  -stretch boolean
    部品が寸法変更されるか､先頭列区切を使用者が引き摺った時に､ 列巾が調整されるか否かを指定する｡ 論理値booleanは､Tcl_GetBooleanに受容れ可能などの様な形式でも好い｡ 無為設定では､伸張可能である｡ Specifies whether or not the column width should be adjusted when the widget is resized or the user drags a heading 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 heading column separator.

  pathname column #0 を樹枝列の構成設定に使われたい｡ Use pathname fBcolumn #0 to configure the tree column.

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 detached ?item?
  もし､itemが提供されると､それが､連結を断たれた品目か否かを 指し示す論理値を返す(detach参照)｡ それ以外は､連結を断たれた全ての品目のリスト(任意の順序)を返す｡ 根本の品目は連結を断たれる事はない｡ If item is provided, returns a boolean value indicating whether it is the name of a detached item (see detach). Otherwise, returns a list of all the detached items (in an arbitrary order). The root item is never detached.

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 cell x y
    位置 x y にあるセルの識別子を返す｡ セルの識別子は､品目 識別子と列識別子のリストである｡ Returns the cell identifier of the cell at position x y. A cell identifier is a list of item ID and column ID.

  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 negative or 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 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 negative or 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?
  品目選択を管理する｡品目選択は､cellselection命令によって取扱われるセル選択から独立している｡ もし､selop が指定されないと､選択された品目のリストを返す｡ それ以外は､ selop は次の内の一つである: Manages item selection. Item selection is independent from cell selection handled by the cellselection command. 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 tag args...
  貼札を管理する｡貼札は､セル上と同じ様に品目上に設定され得る｡ 貼札の設定は､品目とセルの間で共有される｡ 但し､品目の貼札張りはセルへの貼札張りとは独立している (譬えば､品目上への貼札追加は､その品目内のセル上への貼札追加にはならない)｡ セル貼札は､描写の時に､品目貼札に優先する｡ 次の副命令に対応している: Manages tags. Tags can be set on items as well as on cells. The set of tags is shared between items and cells. However item tagging is independent from cell tagging (for instance adding a tag on an item does not also add this tag on the cells in that item). Cell tags take precedence over item tags when drawing. The following subcommands are supported:

  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 bind tagName ?sequence? ?script?
    Tk 束縛記述譜を､引続く行事の sequence の為に､貼り札 tagName に加える｡ X 行事は品目､に配付され､それぞれの品目の -tags の為の束縛記述譜は順番に bindtags(n) を通して評価される｡ 　　 もし､行事がせる(即ち､マウスの行事)と関連していると､せるの-tagsの為のどの束縛も同じに評価される｡ 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). If the event can be associated with a cell (i.e. mouse events) any bindings for the cell's -tags are evaluated as well.

    <Key>と<KeyRelease>と仮想行事は､対象になっている品目に送られる｡ <Button>と<ButtonRelease>と<Motion>行事は､マウス指示子の下の品目に送られる｡ それ以外の行事型には対応しない｡ <Key>, <KeyRelease>, and virtual events are sent to the focus item. <Button>, <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 cell subcommand...
    セル上の個別の貼札を管理する｡ cellList引数は､単一のセル又は､セルのリストであり得る｡ Manages tags on individual cells. A cellList argument may be a single cell or a list of cells.

    pathName tag cell add tag cellList
      指定された tag を列挙されたcellListのそれぞれに加える｡ もし､tagが既に､特定のセルについて存在すると､そのセルの貼札リストは変化しない｡ Adds the specified tag to each of the listed cellList. If tag is already present for a particular cell, then the tag list for that cell is unchanged.

    pathName tag cell has tagName ?cell?
      もしcellが指定されると､指定されたセルが名付けられた貼札を有しているか否かに従って 1 か 0を返す｡ それ以外は､指定された貼札を有する全てのセルのリストを返す｡ If cell is specified, returns 1 or 0 depending on whether the specified cell has the named tag. Otherwise, returns a list of all cells which have the specified tag.

    pathName tag cell remove tag ?cellList?
      指定された貼札 tagを列挙されたcellListのそれぞれから除去する｡ もし､セルのリストcellListが省略されると､樹枝内のそれぞれのセルから tagを除去する｡ Removes the specified tag from each of the listed cellList. If cellList is omitted, removes tag from each cell in the tree.

  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 delete tagName
    tagName引数に拘る全ての貼札情報を削除する｡ 本命令は､全ての品目と､部品内のセルと､から貼札を除去し､且つ､ 束縛や表示情報の様な貼札に拘るどのような他の情報も削除する｡本命令は空文字列を返す｡ Deletes all tag information for the tagName argument. The command removes the tag from all items and cells in the widget and also deletes any other information associated with the tag, such as bindings and display information. The command returns an empty string.

  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 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.

### ITEM OPTIONS

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

-text
  樹枝列内の品目に関する､表示する為の､文書名札｡ The textual label to display for the item in the tree column.

-height
  品目の高さ､-rowheightの整数倍数｡無為設定は1｡ The height for the item, in integer multiples of -rowheight. Default is 1.

-image
  Tk 影像であって､樹枝列内の名札の隣に表示され､ -imageanchorに従って置かれる｡ A Tk image, displayed next to the label in the tree column, placed according to -imageanchor.

-imageanchor
  -imageが文書に対して､如何に表示されるかを指定する｡ 無為設定はw西｡標準のTk 錨値の内の一つ｡ Specifies how the -image is displayed relative to the text. Default is w. One of the standard Tk anchor values.

-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.

-hidden
  この品目は表示されるべき(-hidden false)か､隠蔽されるべきか(-hidden true)を､ 示す論理値｡ もし､親が隠蔽の場合､全ての子孫は同じく隠蔽である｡ A boolean value indicating whether this item should be displayed (-hidden false) or hidden (-hidden true). If a parent is hidden, all its decendants are hidden too.

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

-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
  セル又は品目の映像を指定する｡ Specifies the cell or item image.

-imageanchor
  セル又は品目影像錨を指定する｡ Specifies the cell or item image anchor.

-padding
  セルの詰物を指定する｡データセルは無為設定の詰物{4 0}を有すことになる｡ Specifies the cell padding. A data cell will have a default padding of {4 0}

-stripedbackground
  もし､-stripedが真値の場合､ セルまたは品目代替行の為の背景色を指定する｡ Specifies the cell or item background color for alternate lines, if -striped is true.

セル上の貼札は､品目上の貼札を凌駕する優先順位を有す｡ 従って､貼札の優先度は､生成順で決められる: 最初に生成された貼札が高い優先度を受取る｡ 品目の指示項目は､-imageや-imageanchorの様に､貼札を凌駕する優先度を有す｡ Tags on cells have precedence over tags on items. Then, tag priority is decided by the creation order: tags created first receive higher priority. An item's options, like -image and -imageanchor, have priority over tags.

### IMAGES

品目上の､及び､品目貼札上の､-image指示項目は､ 樹枝列内の名札の次に映像を管理する[訳註:???] 他のセルはセル貼札の -image 指示項目経由で影像を持ち得る｡ The -image option on an item, and on an item tag, controls the image next to the label in the tree column. Other cells can have images through the cell tag -image option.

### 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.

column識別子は､単純整数索引算術とendへの相対索引を伴う 命令string indexに従った簡単な解釈に対応する｡ Column identifiers support the same simple interpretation as for the command string index, with simple integer index arithmetic and indexing relative to end.

註意: 品目 -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 or cellselection 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.

-columnseparatorwidth amount

  列の隔離板の厚さを指定する｡無為設定は1画素｡ 値はTk_GetPixelsに受容れられるどの形式でも好い｡ Specifies the width of column separators. Defaults to 1 pixel. 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を設定するかの用例､ 無為設定を設定するのに似た方法でフォントに適用する: Example of how to set -rowheight, adapting to a font in a similar way to how the default value is set:

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

-stripedbackground color

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