## Tcl9.0.3/Tk9.0.3 Documentation > Tk Commands > ttk_notebook

### 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::notebook — 複数の小窓を収容する部品 　　Multi-paned container widget
  SYNOPSIS
  説明 DESCRIPTION
  STANDARD OPTIONS
    -class, undefined, undefined
    -cursor, cursor, Cursor
    -style, style, Style
    -takefocus, takeFocus, TakeFocus
  部品固有の指示項目 WIDGET-SPECIFIC OPTIONS
    -height, height, Height
    -padding, padding, Padding
    -width, width, Width
  TAB OPTIONS
    -state, state, State
    -sticky, sticky, Sticky
    -padding, padding, Padding
    -text, text, Text
    -image, image, Image
    -compound, compound, Compound
    -underline, underline, Underline
  舌(ベロ)の識別子 TAB IDENTIFIERS
  WIDGET COMMAND
    pathname add window ?options...?
    pathname forget tabid
    pathname hide tabid
    pathname identify component x y
      pathname identify element x y
      pathname identify tab x y
    pathname index tabid
    pathname insert pos subwindow options...
    pathname select ?tabid?
    pathname tab tabid ?-option ?value ...
    pathname tabs
  打鍵移動 KEYBOARD TRAVERSAL
  仮想行事 VIRTUAL EVENTS
  用例 EXAMPLE
  様式の指示項目 STYLING OPTIONS
  SEE ALSO
  KEYWORDS

### NAME

ttk::notebook — 複数の小窓を収容する部品 　　Multi-paned container widget

### SYNOPSIS

ttk::notebook pathname ?options...?
pathname add window ?options...?
pathname insert index window ?options...?

### 説明 DESCRIPTION

ttk::notebook 部品は窓の集まりを管理する､また､同時にはその一つを表示する｡それぞれの子供の窓は舌(べろ)と結合しており､それは､使用者が現在表示されている窓を変更する為に使うことができる｡ A ttk::notebook widget manages a collection of windows and displays a single one at a time. Each content window is associated with a tab, which the user may select to change the currently-displayed window.

### STANDARD OPTIONS

-class, undefined, undefined
-cursor, cursor, Cursor
-style, style, Style
-takefocus, takeFocus, TakeFocus

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

Command-Line Name: -height
Database Name: height
Database Class: Height
  もし零より大きい値が与えられると､小窓の望ましい高さを指定する(内部の詰ものや舌を含まない)｡それ以外の場合､全ての小窓の内の最大の高さが使われる｡ 　 If present and greater than zero, specifies the desired height of the pane area (not including internal padding or tabs). Otherwise, the maximum height of all panes is used.

Command-Line Name: -padding
Database Name: padding
Database Class: Padding
  帳面の外側の周りに追加される余分の空間の量を指定する｡この詰め方は､左､頂､右､底を指定する 四つ以下の長さのリストである｡もし四つより少ない要素が指定された場合､底の省略時設定は頂､右の省略時設定は左､頂の省略時設定は左である｡ 謂い換えると､３つの数字は左､垂直､右の詰め方を指定する; ２つの数字は水平と､垂直の詰め方を指定する; 一つの数字は部品の周りの全ての同じ詰め方を指定する｡　　　 Specifies the amount of extra space to add around the outside of the notebook. The padding is a list of up to four length specifications left top right bottom. If fewer than four elements are specified, bottom defaults to top, right defaults to left, and top defaults to left. In other words, a list of three numbers specify the left, vertical, and right padding; a list of two numbers specify the horizontal and the vertical padding; a single number specifies the same padding all the way around the widget.

Command-Line Name: -width
Database Name: width
Database Class: Width
  もし存在して零より大きい場合､小窓の望ましい幅を指定する(内部の詰ものや舌を含まない)｡有効に指定されないと､全ての小窓の内の最大の巾が使われる｡ If present and greater than zero, specifies the desired width of the pane area (not including internal padding). Otherwise, the maximum width of all panes is used.

### TAB OPTIONS

次の指示項目が個別の帳面小窓の為に指定され得る: 　　 The following options may be specified for individual notebook panes:

Command-Line Name: -state
Database Name: state
Database Class: State
  normal か disabled か hidden ｡もし disabled の場合､舌(ベロ)は選択できない｡もし hidden の場合舌は示されない｡ Either normal, disabled or hidden. If disabled, then the tab is not selectable. If hidden, then the tab is not shown.

Command-Line Name: -sticky
Database Name: sticky
Database Class: Sticky
  子供の窓を小窓の内部に如何に位置決めするか指定する｡値は n か s か e か w の文字を零個またはそれ以上含む文字列である｡それぞれの文字は､格子幾何管理譜向けの要領で､子供の窓が “くっ付く” 側(東西南北)を参照する｡ 　　　 Specifies how the content window is positioned within the pane area. Value is a string containing zero or more of the characters n, s, e, or w. Each letter refers to a side (north, south, east, or west) that the content window will “stick” to, as per the grid geometry manager.

Command-Line Name: -padding
Database Name: padding
Database Class: Padding
  帳面とこの小窓との間に追加する余分の空間の量を指定する｡構文は -padding 指示項目の為のものと同じ｡ 　　 Specifies the amount of extra space to add between the notebook and this pane. Syntax is the same as for the widget -padding option.

Command-Line Name: -text
Database Name: text
Database Class: Text
  舌(べろ)の中に表示される文字列を指定する｡ 　 Specifies a string to be displayed in the tab.

Command-Line Name: -image
Database Name: image
Database Class: Image
  舌(べろ)の中に表示される影像を指定する｡詳細は ttk_widget(n) を参照のこと｡ 　　 Specifies an image to display in the tab. See ttk_widget(n) for details.

Command-Line Name: -compound
Database Name: compound
Database Class: Compound
  影像を如何に表示するかを文書に相対的に指定する､両方の場合 -text と -image が存在する｡適正な値については label(n) を参照されたい｡ 　　 Specifies how to display the image relative to the text, in the case both -text and -image are present. See label(n) for legal values.

Command-Line Name: -underline
Database Name: underline
Database Class: Underline
  文書文字列内の下線を引く文字の整数位置(0から数える)を指定する｡もし ttk::notebook::enableTraversal が呼ばれる場合､下線を引かれた文字は記憶を呼覚ます為に使われる｡ 　　 Specifies the integer index (0-based) of a character to underline in the text string. The underlined character is used for mnemonic activation if ttk::notebook::enableTraversal is called.

### 舌(ベロ)の識別子 TAB IDENTIFIERS

命令に続く舌(ベロ)の識別子引数は次の形式のどれかをとり得る: 　 The tabid argument to the following commands may take any of the following forms:

- 零と舌(ベロ)の個数の間の整数; 　 An integer between zero and the number of tabs;

- 子供の窓の名前; 　 The name of a content window;

- 舌を識別する “@x,y” の形式の位置の指定｡ 　 A positional specification of the form “@x,y”, which identifies the tab

- 文字列 “current” そのものの､これは現在選択されている舌であり;最後に: 　　 The literal string “current”, which identifies the currently-selected tab; or:

- 文字列 “end” そのものの､これは舌の数を返す( “pathname index” に対してのみ適正)｡ 　　 The literal string “end”, which returns the number of tabs (only valid for “pathname index”).

索引は同じ簡単な解釈として 単純整数参照算術とendへの相対参照を伴う string index命令 に､対応する｡ Indexes support the same simple interpretation as for the command string index, with simple integer index arithmetic and indexing relative to end.

### WIDGET COMMAND

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

pathname add window ?options...?
  帳面に新しい舌(べろ)を追加する｡利用できる options のリストは TAB OPTIONS を参照されたい｡もし window が現在帳面に管理されているが隠蔽されていると､以前の場所に再保存される｡ Adds a new tab to the notebook. See TAB OPTIONS for the list of available options. If window is currently managed by the notebook but hidden, it is restored to its previous position.

pathname forget tabid
  tabid で指定される舌(べろ)を取去り､結合していた窓を管理対象から除く｡ 　　 Removes the tab specified by tabid, unmaps and unmanages the associated window.

pathname hide tabid
  tabid で指定される舌を隠す｡舌は表示されなくなるが､結合していた窓は帳面に管理され､その構成設定も記憶される｡隠された舌は add 命令で再度保存される｡ 　　 Hides the tab specified by tabid. The tab will not be displayed, but the associated window remains managed by the notebook and its configuration remembered. Hidden tabs may be restored with the add command.

pathname identify component x y
  x と y によって与えられる点の下の要素の名前を返すかその場所に要素が何もないと空文字列を返す｡次の副命令が運営されている: 　　 Returns the name of the element under the point given by x and y, or the empty string if no component is present at that location. The following subcommands are supported:

  pathname identify element x y
    指定された場所にある要素の名前を返す｡ 　 Returns the name of the element at the specified location.

  pathname identify tab x y
    指定された場所にある舌の索引を返す｡ 　 Returns the index of the tab at the specified location.

pathname index tabid
  tabid で指定される舌(ベロ)の索引番号を返す､もし tabid が文字列 “end” の場合は舌の総個数を返す｡ 　　 Returns the numeric index of the tab specified by tabid, or the total number of tabs if tabid is the string “end”.

pathname insert pos subwindow options...
  指定された場所に小窓を挿入する｡ pos は文字列 end か索引番号か管理された子供の窓の名前である｡もし subwindow が既に帳面に管理されている場合､指定された場所にそれを移動する｡利用できる指示項目のリストに就いては TAB OPTIONS を参照されたい｡ 　　 Inserts a pane at the specified position. pos is either the string end, an integer index, or the name of a managed subwindow. If subwindow is already managed by the notebook, moves it to the specified position. See TAB OPTIONS for the list of available options.

pathname select ?tabid?
  指定された舌を選択する｡関連した仔供の窓が表示される､又､それまで選択されていた窓(別の窓の場合)は対応が外れる｡もし tabid が省略さると現在選択されている小窓の部品名を返す｡ 　 Selects the specified tab. The associated content window will be displayed, and the previously-selected window (if different) is unmapped. If tabid is omitted, returns the widget name of the currently selected pane.

pathname tab tabid ?-option ?value ...
  指定した舌の指示項目を問合せ又は修正する｡ -option が全く指定されない場合､舌の指示項目の値の辞書が返る｡もし一つの -option が指定されるとその指示項目の値が返る｡それ以外の場合､ -option に対応する値を設定する｡利用できる指示項目に就いては TAB OPTIONS を参照されたい｡ 　　 Query or modify the options of the specific tab. If no -option is specified, returns a dictionary of the tab option values. If one -option is specified, returns the value of that option. Otherwise, sets the -options to the corresponding values. See TAB OPTIONS for the available options.

pathname tabs
  関連した舌(べろ)の索引の順で､帳面に管理されている窓のリストを返す｡ 　　 Returns the list of windows managed by the notebook, in the index order of their associated tabs.

### 打鍵移動 KEYBOARD TRAVERSAL

帳面部品 $nb を含む頂上水準の為の打鍵移動を可能にするには､之を呼ぶ: 　　　 To enable keyboard traversal for a toplevel window containing a notebook widget $nb, call:

    ttk::notebook::enableTraversal $nb

これは次の如く帳面部品を含む頂上水準の為の束縛を拡張する: 　　 This will extend the bindings for the toplevel window containing the notebook as follows:

- Control-Tab は現在選択されている舌(ベロ)に続く舌を選択する｡ Control-Tab selects the tab following the currently selected one.

- Shift-Control-Tab は現在選択されている舌の手前の舌を選択する｡ Control-Shift-Tab selects the tab preceding the currently selected one.

- Alt-K ここで K はどれかの舌の簡略記憶記号(下線が引かれた)文字であり､その舌を選択する｡ Alt-K, where K is the mnemonic (underlined) character of any tab, will select that tab.

一つの頂上水準内の複数の帳面の捲(めく)りも可能である､入れ子になった帳面も含まれる｡しかし､帳面の捲りは､全ての小窓が帳面の直接の子供である場合にのみ正しく動作する｡ 　　 Multiple notebooks in a single toplevel may be enabled for traversal, including nested notebooks. However, notebook traversal only works properly if all panes are direct children of the notebook.

### 仮想行事 VIRTUAL EVENTS

帳面部品は新しい舌が選択された後､仮想行事 <<NotebookTabChanged>> を生成する｡ The notebook widget generates a <<NotebookTabChanged>> virtual event after a new tab is selected.

### 用例 EXAMPLE

    pack [ttk::notebook .nb]
    	.nb add [frame .nb.f1] -text "First tab"
    	.nb add [frame .nb.f2] -text "Second tab"
    	.nb select .nb.f2
    ttk::notebook::enableTraversal .nb

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

ttk::notebook の級の名前は TNotebook である｡tab は TNotebook.Tab の級の名前を有する｡　　　　　　 The class name for a ttk::notebook is TNotebook. The tab has a class name of TNotebook.Tab

Dynamic states: active, disabled, selected.

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

-background color
-bordercolor color
-darkcolor color
-foreground color
-lightcolor color
-padding padding
-tabmargins padding
-tabposition position

  舌の行又は列の位置を長さ 1 又は 2 の文字列として設定する｡最初の文字は n 又は, s 又は w, 又は e として方向を示し､第二の文字は(それがあれば)､舌の位置の内部の接着破片 (w 又は, e 又は n, 又は s として指定される) である｡無為設定の位置は 水の主題の為には n ､それ以外の全ての組込み主題の為には nw である｡ Specifies the position of the tab row or column as a string of length 1 or 2. The first character indicates the side as n, s, w, or e, while the second character (if present) is the sticky bit (specified as w, e, n, or s) within the tab position. The default position is n for the aqua theme and nw for all the other built-in themes.

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

-background color
-bordercolor color
-compound compound
-expand padding

  舌の寸法が幾ら大きくなるかを定義する｡通常選択された動的状態に使用される｡ -tabmargins は舌の成長の為に余裕があるように適切に設定されるべき｡譬えば､ Ttk 外部函数ファイルの vistaTheme.tcl は次の行を含む Defines how much the tab grows in size. Usually used with the selected dynamic state. -tabmargins should be set appropriately so that there is room for the tab growth. For example, the Ttk library file vistaTheme.tcl contains the lines

      ttk::style configure TNotebook -tabmargins {2 2 2 0}
      ttk::style map TNotebook.Tab -expand {selected {2 2 2 2}}

  これは､舌位置 -tabposition 様式選択項目の無為設定値 nw の為に正当である｡ttk::notebook 様式の為には､nbStyle は次の様に定義される which are valid for the default value nw of the -tabposition style option. For a ttk::notebook style nbStyle defined by

      set nbStyle SW.TNotebook
      ttk::style configure $nbStyle -tabposition sw

  上述の設定を次の様に適用すべきである: you will have to adapt the above settings as follows:

      ttk::style configure $nbStyle -tabmargins {2 0 2 2}
      ttk::style map $nbStyle.Tab -expand {selected {2 2 2 2}}

  これを簡単に行う方法は､様式の -tabposition 指示項目を設定した後､引数として $nbStyle を添えて外部函数手続 ttk::configureNotebookStyle を起動する事である｡ The easiest way to do this is to invoke the library procedure ttk::configureNotebookStyle with $nbStyle as argument, after setting the style's -tabposition option.

-font font
-foreground color
-padding padding

  幾つかの主題は選択された舌の為に違う詰込みを使う｡譬えば､ Ttk 外部函数ファイル clamTheme.tcl は次の行を含み､ Some themes use a different padding for the selected tab. For example, the Ttk library file clamTheme.tcl contains the lines

      ttk::style configure TNotebook.Tab \
          -padding {4.5p 1.5p 4.5p 1.5p}
      ttk::style map TNotebook.Tab \
          -padding {selected {4.5p 3p 4.5p 1.5p}}

  これは､舌位置 -tabposition 様式選択項目の無為設定値 nw の為に正当である｡ ttk::notebook 様式に関して異なる舌位置を有する､それに応じて上述の設定を適用すべきである｡再度､それを行うには､様式の -tabposition 指定項目設定の後に､引数として様式の名前を添えて､外部函数手続き ttk::configureNotebookStyle を起動することである｡ which are valid for the default value nw of the -tabposition style option. For a ttk::notebook style having a different tab position you will have to adapt the above settings accordingly. Again, the easiest way to do this is to invoke the library procedure ttk::configureNotebookStyle with the style name as argument, after setting the style's -tabposition option.

幾つかの指示項目は特別の主題の為にのみ利用できる｡　　　　 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, grid

### KEYWORDS

pane, tab
Copyright © 2004 Joe English