目次　Table of Contents

_________________________________________________________________

## 名称　Name

table - 表の生成と操作　　 Create and manipulate tables

## 構文 Synopsis

table pathName ?options?

## 標準の指示項目　　 Standard Options

-anchor
  -background -cursor
-exportselection
  -font -foreground
-highlightbackground
  -highlightcolor -highlightthickness
-insertbackground
  -insertborderwidth-insertofftime -insertontime -insertwidth -invertselected
-relief
  -takefocus -xscrollcommand -yscrollcommand

標準の指示項目の詳細については取扱い説明書の指示項目の欄を見られたい｡　 See the options manual entry for details on the standard options.

## 部品固有の指示項目　　Widget-specific Options

Command-Line Name:-autoclear
Database Name: autoClear
Database Class: AutoClear

欄内の最初の鍵盤押下が何であれ以前からあった文書を削除するか否かを指定する論理値｡無為設定は 0｡　　 A boolean value which specifies whether the first keypress in a cell will delete whatever text was previously there. Defaults to 0.

Command-Line Name:-bordercursor
Database Name: borderCursor
Database Class: Cursor

遊走子が境界の上に架かった時に対話的再寸法調整が許容されている視覚的表示を表示すべき名前を指定する(即ち -resizeborders の値によって影響される)｡無為設定は細い十字｡　 Specifies the name of the cursor to show when over borders, a visual indication that interactive resizing is allowed (it is thus affect by the value of -resizeborders). Defaults to crosshair.

Command-Line Name:-borderwidth or -bd
Database Name: borderWidth
Database Class: BorderWidth

非負数の画素値､又は表内部の三次元境界の幅を指示す値のリスト(もしその様な境界が描かれると; 典型的には relief 指示項目がそれを指定する)｡もし値が一つ指定されるとその幅の矩形が指定される｡もし値が二つ指定されると､欄の右縁と左縁のみが境界を有する｡もし4つの値が指定されると､｛左､右､上､底｝縁がそれに対応する｡これは貼り札の境界幅指定により上書きされ得る｡又､表の為の -drawmode の指定にも影響をうけるかもしれない｡リスト内のそれぞれの値はTk_GetPixelsに受入れ可能な書式の内の一つを有さねばならない｡　　　 Specifies a non-negative pixel value or list of values indicating the width of the 3-D border to draw on interior table cells (if such a border is being drawn; the relief option typically determines this). If one value is specified, a rectangle of this width will be drawn. If two values are specified, then only the left and right edges of the cell will have borders. If four values are specified, then the values correspond to the {left right top bottom} edges. This can be overridden by the a tag's borderwidth option. It can also be affected by the defined -drawmode for the table. Each value in the list must have one of the forms acceptable to Tk_GetPixels.

Command-Line Name:-browsecommand or -browsecmd Database Name: browseCommand
Database Class: BrowseCommand

活性な欄が変化した時はいつも評価されるべき命令を指定する｡ 下の COMMAND SUBSTITUTION に記述された百分率置換模型を使用する｡ Specifies a command which will be evaluated anytime the active cell changes. It uses the %-substition model described in COMMAND SUBSTITUTION below.

Command-Line Name:-cache
Database Name: cache
Database Class: Cache

表の内容の内部高速記憶が保持されるべきか否かを指定する論理値｡ これは -command と一緒に使用される時には大いに高速化されるが､追加の記憶域を使用する｡ -command と -variable の両方が空の時の状態が維持できるか｡ -cache 又は -variable の値が変更される時は何時でも高速記憶は自動的に消去される､それ以外では使用者は消去実行を明示的に呼出す必要がある｡無為設定は消去否である｡　　 A boolean value that specifies whether an internal cache of the table contents should be kept. This greatly enhances speed performance when used with -command but uses extra memory. Can maintain state when both -command and -variable are empty. The cache is automatically flushed whenever the value of -cache or -variable changes, otherwise you have to explicitly call clear on it. Defaults to off.

Command-Line Name:-colorigin
Database Name: colOrigin
Database Class: Origin

何番を表内の最左端列として解釈すべきかを指定する｡この値は表内で使用者用番号として使われる｡無為設定は0 ｡ Specifies what column index to interpret as the leftmost column in the table. This value is used for user indices in the table. Defaults to 0.

Command-Line Name:-cols
Database Name: cols
Database Class: Cols

表内の列数｡無為設定は10 ｡ Number of cols in the table. Defaults to 10.

Command-Line Name:-colseparator
Database Name: colSeparator
Database Class: Separator

表内のデータを切ったり貼ったりした時に列分離印として解釈されるべき分離文字を指定する｡無為設定では､列はtclリストの要素として分離されている｡　 Specifies a separator character that will be interpreted as the column separator when cutting or pasting data in a table. By default, columns are separated as elements of a tcl list.

Command-Line Name:-colstretchmode
Database Name: colStretchMode
Database Class: StretchMode

余分に割当てられた窓空間を埋めるために次の列の引伸し様式の内の一つを指定する: none 列は割当てられた窓空間を満たす為に引伸ばされない｡もし列が狭すぎる場合､表の右側に空白空間ができる｡これが無為設定である｡ Specifies one of the following stretch modes for columns to fill extra allocated window space: none Columns will not stretch to fill the assigned window space. If the columns are too narrow, there will be a blank space at the right of the table. This is the default.

unset 巾が指定されていない列のみが引伸ばされる｡ unset Only columns that do not have a specific width set will be stretched.

all
  表に割当てられた窓の空間を充たす為に､同じ数の画素によって列が引伸ばされる｡この様式は列巾を強制するよう試みる対話的な縁の再寸法設定によって影響され得る｡ All columns will be stretched by the same number of pixels to fill the window space allocated to the table. This mode can interfere with interactive border resizing which tries to force column width.

last 表に割当てられた窓の空間を充たす為に､最後の列が引伸ばされる｡ last The last column will be stretched to fill the window space allocated to the table.

fill (only valid for -rowstretch currently)
(現在-rowstretch についてのみ有効) 表に割当てられた窓空間に従って､表は､多く或いは少なく列を得る｡この様式は膨大な 奇癖を有し､将来は消滅するかもしれない｡ The table will get more or less columns according to the window space allocated to the table. This mode has numerous quirks and may disappear in the future.

Command-Line Name:-coltagcommand
Database Name: colTagCommand
Database Class: TagCommand

与えられた列の為に使用される札を決定する為に部品によって評価される手続き関数の名前を提供する｡ 欄を表示する時､表部品は最初に tag col 部品手段を使用して定義されたか否かを確認する｡もし札が何も見つからない場合､単独の引数として疑問の中の列番号を渡す指定された手続き関数を評価する｡その手続き関数は使うべき札の名前若しくは空文字列を返すことが期待される｡手続き関数の評価中に起こる不都合､又は不正な札の戻りは報告されないまま無視される｡　　 Provides the name of a procedure that will be evaluated by the widget to determine the tag to be used for a given column. When displaying a cell, the table widget will first check to see if a tag has been defined using the tag col widget method. If no tag is found, it will evaluate the named procedure passing the column number in question as the sole argument. The procedure is expected to return the name of a tag to use, or a null string. Errors occuring during the evaluation of the procedure, or the return of an invalid tag name are silently ignored.

Command-Line Name:-colwidth
Database Name: colWidth
Database Class: ColWidth

無為設定の列巾､正の数の時は無為設定の字母単位の文字と解釈され､負数の時は画素単位である｡無為設定は10｡ Default column width, interpreted as characters in the default font when the number is positive, or pixels if it is negative. Defaults to 10.

Command-Line Name:-command
Database Name: command
Database Class: Command

欄の値に手続きの対話として使用される命令を指定する｡もし-usecommand が真値の場合､この命令は-variable 配列にどのような参照よりも､この命令が使用される｡欄の値を取出す時､この欄の値としてこの命令の返り値が使用される｡これは下の COMMAND SUBSTITUTION 内に記述する百分率置換模型を使用する｡ Specified a command to use as a procedural interface to cell values. If -usecommand is true, this command will be used instead of any reference to the -variable array. When retrieving cell values, the return value of the command is used as the value for the cell. It uses the %-substition model described in COMMAND SUBSTITUTION below.

Command-Line Name:-drawmode
Database Name: drawMode
Database Class: DrawMode

次の指定の内の一つを表の描画様式に設定する｡ Sets the table drawing mode to one of the following options:

slow 表は Tk 縁取り函数を使用して視野外画面画素地図に描かれる()｡これは瞬きがない事を意味するが､この様式は大きな表では遅い｡ slow The table is drawn to an offscreen pixmap using the Tk bordering functions (doublebuffering). This means there will be no flashing, but this mode is slow for larger tables.

compatible
表はTk 縁函数を使って画面に直接描かれる｡速いが､更新時に画面が瞬くかもしれない｡これが無為設定である｡ The table is drawn directly to the screen using the Tk border functions. It is faster, but the screen may flash on update. This is the default.

fast 表は画面に直接描かれ､縁は速い X 呼出しによってなされる､その為常に１画素だけ広くなる｡副作用として､-borderwidth を 0 か 1の間に制限する｡ この様式は､大きな表では最良の出来栄えを提供するが､再描画の際瞬くかもしれず縁様式で Tk とは 100% 互換ではない｡ fast The table is drawn directly to the screen and the borders are done with fast X calls, so they are always one pixel wide only. As a side effect, it restricts -borderwidth to a range of 0 or 1. This mode provides best performance for large tables, but can flash on redraw and is not 100% Tk compatible on the border mode.

single 表は画面に高速様式として描かれるが､単線の画素として描かれる(四角い縁ではない)｡ single The table is drawn to the screen as in fast mode, but only single pixel lines are drawn (not square borders).

Command-Line Name:-flashmode
Database Name: flashMode
Database Class: FlashMode

欄の値が変化した時に欄が瞬くか否かを指定する論理値｡表の札の瞬きは､-flashtime によって期間を指定された欄に適用される｡無為設定は0 ｡ A boolean value which specifies whether cells should flash when their value changes. The table tag flash will be applied to these cells for the duration specified by -flashtime. Defaults to 0.

Command-Line Name:-flashtime
Database Name: flashTime
Database Class: FlashTime

時間の大きさであって､ 1/4 秒刻みで増加し､欄の値が変化させられた時に瞬く為のもの｡-flashmode が是でなければならない｡無為設定は2 ｡ The amount of time, in 1/4 second increments, for which a cell should flash when its value has changed. -flashmode must be on. Defaults to 2.

Command-Line Name:-height
Database Name: height
Database Class: Height

行内の､窓の為の望ましい高さを指定する｡ 零又はそれ以下の場合､窓の為の望ましい高さは表内の全ての行を保有するに足る大きさになる｡高さは-maxheight によって制限することができる｡ Specifies the desired height for the window, in rows. If zero or less, then the desired height for the window is made just large enough to hold all the rows in the table. The height can be further limited by -maxheight.

Command-Line Name:-invertselected
Database Name: invertSelected
Database Class: InvertSelected

欄が選択された時､その値を交換させるべき Specifies whether the foreground and background of an item should simply have their values swapped instead of merging the sel tag options when the cell is selected. Defaults to 0 (merge sel tag).

Command-Line Name:-ipadx
Database Name: ipadX
Database Class: Pad

欄内の文書のために充填する内部横方向偏移を指定する画素の値｡この値は欄の寸法を増加しない､描かれるべき文書が欄の縁から離れることを惹起こすだけである｡片側(錨に従った)だけに影響を及ぼす｡無為設定は0 ｡代わりの充填様式については -padx を参照されたい｡ A pixel value specifying the internal offset X padding for text in a cell. This value does not grow the size of the cell, it just causes the text to be drawn further from the cell border. It only affects one side (depending on anchor). Defaults to 0. See -padx for an alternate padding style.

Command-Line Name:-ipady
Database Name: ipadY
Database Class: Pad

欄内の文書のために充填する内部縦方向偏移を指定する画素の値｡この値は欄の寸法を増加しない､描かれるべき文書が欄の縁から離れることを惹起こすだけである｡片側(錨に従った)だけに影響を及ぼす｡無為設定は0 ｡代わりの充填様式については -pady を参照されたい｡ A pixel value specifying the internal offset Y padding for text in a cell. This value does not grow the size of the cell, it just causes the text to be drawn further from the cell border. It only affects one side (depending on anchor). Defaults to 0. See -pady for an alternate padding style.

Command-Line Name:-maxheight
Database Name: maxHeight
Database Class: MaxHeight

窓が要求する画素単位の最大高さ｡無為設定は600 ｡ The max height in pixels that the window will request. Defaults to 600.

Command-Line Name:-maxwidth
Database Name: maxWidth
Database Class: MaxWidth

窓が要求する画素単位の最大巾｡無為設定は 800 ｡ The max width in pixels that the window will request. Defaults to 800.

Command-Line Name:-multiline
Database Name: multiline
Database Class: Multiline

多行札指定の為の無為設定を指定する｡無為設定は1 ｡ Specifies the default setting for the multiline tag option. Defaults to 1.

Command-Line Name:-padx
Database Name: padX
Database Class: Pad

欄の為に横方向充填する偏移を指定する画素値｡この値は､width 命令により欄巾の為に特定の画素寸法を選択しない限り､欄の無為設定寸法を値の倍(その値を両方向に)だけ増加することを惹き起こす｡これはそれぞれの右と左の欄末に空領域を強制する｡この充填は欄内の全ての型に影響を及ぼす｡無為設定は0 ｡代わりの充填様式については -ipadx を参照されたい｡　　 A pixel value specifying the offset X padding for a cell. This value causes the default size of the cell to increase by two times the value (one for each side), unless a specific pixel size is chosen for the cell with the width command. This will force an empty area on the left and right of each cell edge. This padding affects all types of data in the cell. Defaults to 0. See -ipadx for an alternate padding style.

Command-Line Name:-pady
Database Name: padY
Database Class: Pad

欄の為に縦方向充填する偏移を指定する画素値｡この値は､height 命令により欄の為に特定の画素寸法を選択しない限り､欄の無為設定寸法を値の倍(その値を両方向に)だけ増加することを惹き起こす｡これはそれぞれの頂と底の欄末に空領域を強制する｡この充填は欄内の全ての型に影響を及ぼす｡無為設定は0 ｡代わりの充填様式については -ipadx を参照されたい｡　　 A pixel value specifying the offset Y padding for a cell. This value causes the default size of the cell to increase by two times the value (one for each side), unless a specific pixel size is chosen for the cell with the height command. This will force an empty area on the top and bottom of each cell edge. This padding affects all types of data in the cell. Defaults to 0. See -ipadx for an alternate padding style.

Command-Line Name:-resizeborders
Database Name: resizeBorders
Database Class: ResizeBorders

どの種類の対話的縁寸法再設定が許容されるかを指定する､行､列､両方(無為設定)､なしの内のどれかでなければならない｡ Specifies what kind of interactive border resizing to allow, must be one of row, col, both (default) or none.

Command-Line Name:-rowheight
Database Name: rowHeight
Database Class: RowHeight

無為設定の列高さ､正数の場合､無為設定の字母を単位とした行数として解釈される､負数の場合は画素単位｡無為設定は1 ｡ Default row height, interpreted as lines in the default font when the number is positive, or pixels if it is negative. Defaults to 1.

Command-Line Name:-roworigin
Database Name: rowOrigin
Database Class: Origin

どの列番号を表内の再頂として解釈するかを指定する｡この値は表内で使用者の為に使われる｡無為設定は0 ｡ Specifies what row index to interpret as the topmost row in the table. This value is used for user indices in the table. Defaults to 0.

Command-Line Name:-rows
Database Name: rows
Database Class: Rows

表内の列の数｡無為設定は10 ｡ Number of rows in the table. Defaults to 10.

Command-Line Name:-rowseparator
Database Name: rowSeparator
Database Class: Separator

表内でデータを切ったり貼ったりする時､列区切りとして解釈される区切り文字を指定する｡無為設定では列はtcl リストとして区切られる｡ Specifies a separator character that will be interpreted as the row separator when cutting or pasting data in a table. By default, rows are separated as tcl lists.

Command-Line Name:-rowstretchmode
Database Name: rowStretchMode
Database Class: StretchMode

窓空間に割り当てられた余分を充填する為の列の引伸ばし様式を指定する｡適正な指定については-colstretchmode を参照されたい｡ Specifies the stretch modes for rows to fill extra allocated window space. See -colstretchmode for valid options.

Command-Line Name:-rowtagcommand
Database Name: rowTagCommand
Database Class: TagCommand

与えられた列の為に使用される札を定めるために部品によって評価できる手続き函数の名前を提供する｡ 手続き函数は使用者により､一つの引数(列番号)を受取り､且つ､札番号か空文字列を返すように定義されなければならない｡これは列札に適用されることを除いて､-coltagcommand としてと同じ方法で動作する｡ Provides the name of a procedure that can evaluated by the widget to determine the tag to be used for a given row. The procedure must be defined by the user to accept a single argument (the row number), and return a tag name or null string. This operates in a similar manner as -coltagcommand, except that it applies to row tags.

Command-Line Name:-selectioncommand or -selcmd Database Name: selectionCommand
Database Class: SelectionCommand

選択の仕組み(即ち: ≪selection get" の評価)経由で表から選択が取出された時評価される命令を指定する｡ この命令からの返り値は選択の仕組みによって渡される文字列になる｡それは下のCOMMAND SUBSTITUTION の箇所で記述される百分率模型を使用する｡もし不都合が生じると Tcl 背景不都合が生成され何も返されない｡　 Specifies a command to evaluate when the selection is retrieved from a table via the selection mechanism (ie: evaluating «selection get"). The return value from this command will become the string passed on by the selection mechanism. It uses the %-substition model described in COMMAND SUBSTITUTION below. If an error occurs, a Tcl background error is generated and nothing is returned.

Command-Line Name:-selectmode
Database Name: selectMode
Database Class: SelectMode

選択を操作する為の幾つかの様式の内の一つを指定する｡指定項目の値は任意であるが､無為設定の束縛はsingle か browse かmultiple か extended のどれかであると期待されている ; 無為設定の値はbrowse である｡この様式は 2次元であることを除き Tk listbox の為のものと同じようである｡ Specifies one of several styles for manipulating the selection. The value of the option may be arbitrary, but the default bindings expect it to be either single, browse, multiple, or extended; the default value is browse. These styles are like those for the Tk listbox, except expanded for 2 dimensions.

Command-Line Name:-selecttitle
Database Name: selectTitles
Database Class: SelectTitles

表題欄が選択内に許容されているか否かを指定する｡無為設定は0 (不許可)｡ Specifies whether title cells should be allowed in the selection. Defaults to 0 (disallowed).

Command-Line Name:-selecttype
Database Name: selectType
Database Class: SelectType

表の為の選択の幾つかの様式内の一つを指定する｡指定項目の値は row, col, cell, or both ( row && col の意味)の内の一つであるかもしれない； 無為設定は cell である｡この様式は､欄の選択が変化(設定 か 消去)した時に､全体の 行/列 が影響されるか否かを決定する｡ Specifies one of several types of selection for the table. The value of the option may be one of row, col, cell, or both (meaning row && col); the default value is cell. These types define whether an entire row/col is affected when a cell's selection is changed (set or clear).

Command-Line Name:-sparsearray
Database Name: sparseArray
Database Class: SparseArray

関連したTcl 配列が分離した配列(1,無為設定)か全部揃った配列 (0) として保持されるか否かを指定する論理値｡もし真値の場合､欄の値は空の箇所が配列から消去される(記憶域が少ない)｡もし､偽値の場合全ての配列は保持される｡　　 A boolean value that specifies whether an associated Tcl array should be kept as a sparse array (1, the default) or as a full array (0). If true, then cell values that are empty will be deleted from the array (taking less memory). If false, then all values in the array will be maintained.

Command-Line Name:-state
Database Name: state
Database Class: State

Specifies one of two states for the entry:
normal かdisabled ｡もし表が不能であれば､部品命令を使用して値が変化することはなく､喩え入力の注目が部品上にあっても､挿入遊走子も表示されない｡又､全ての挿入と削除手段は無視される｡無為設定は通常｡
  normal or disabled. If the table is disabled then the value may not be changed using widget commands and no insertion cursor will be displayed, even if the input focus is in the widget. Also, all insert or delete methods will be ignored. Defaults to normal.

Command-Line Name:-titlecols
Database Name: titleCols
Database Class: TitleCols

表題領域として使用する列の数｡無為設定は0 ｡ Number of columns to use as a title area. Defaults to 0.

Command-Line Name:-titlerows
Database Name: titleRows
Database Class: TitleRows

表題領域として使用する行の数｡無為設定は0 ｡ Number of rows to use as a title area. Defaults to 0.

Command-Line Name:-usecommand
Database Name: useCommand
Database Class: UseCommand

command 指定を使うか否かを指定する論理値｡command が使われ不都合を返す場合､この値はcommand が使われ､不都合を返す場合､自身を零に設定する｡無為設定は1 (もし指定されるとcommand を使う)｡ A boolean value which specifies whether to use the command option. This value sets itself to zero if command is used and returns an error. Defaults to 1 (will use command if specified).

Command-Line Name:-validate
Database Name: validate
Database Class: Validate

活性緩衝域について妥当性確認が生じるか否かを指定する論理値｡ A boolean specifying whether validation should occur for the active buffer. Defaults to 0.

Command-Line Name:-validatecommand or -vcmd Database Name: validateCommand
Database Class: ValidateCommand

活性の欄が校正されたときに実行すべき命令を指定する｡この命令はTcl 論理値を返すことが期待される｡真値を返す場合､新しい値は可能であると看做され､それ以外では新しい値は拒否される(校正は置換えられない)｡この命令内の不都合は背景内で処理される｡それは下のCOMMAND SUBSTITUTION の箇所で記述される百分率模型を使用する｡ Specifies a command to execute when the active cell is edited. This command is expected to return a Tcl boolean. If it returns true, then it is assumed the new value is OK, otherwise the new value is rejected (the edition will not take place). Errors in this command are handled in the background. It uses the %-substition model described in COMMAND SUBSTITUTION below.

Command-Line Name:-variable
Database Name: variable
Database Class: Variable

表の C 配列に取付ける大域 Tcl 配列変数｡実在しないか単純変数の場合は生成される｡配列の表に使用される鍵は､欄について行,列の形式であり､活性な欄の緩衝域の値を含む特別の鍵が活性である｡Tcl 配列は疎らな配列として管理される(表は全ての有効な番地が値を有することを要求しない)｡値が保存されない番地は空文字列と等価であり､欄の消去は -sparsearray 指定が 0 に設定されてない限り､ Tcl 配列から除去される｡　 Global Tcl array variable to attach to the table's C array. It will be created if it doesn't already exist or is a simple variable. Keys used by the table in the array are of the form row,col for cells and the special key active which contains the value of the active cell buffer. The Tcl array is managed as a sparse array (the table doesn't require all valid indices have values). No stored value for an index is equivalent to the empty string, and clearing a cell will remove that index from the Tcl array, unless the -sparsearray options is set to 0.

Command-Line Name:-width
Database Name: width
Database Class: Width

列の中の窓の為の望ましい巾を指定する｡もし零かそれ以下の場合､窓の為の望ましい巾は表内の全ての列を保有するに足る大きさにされる｡巾は更に-maxwidth によって制限され得る｡ Specifies the desired width for the window, in columns. If zero or less, then the desired width for the window is made just large enough to hold all the columns in the table. The width can be further limited by -maxwidth.

Command-Line Name:-wrap
Database Name: wrap
Database Class: Wrap

札の為の畳み込みの無為設定を指定する｡無為設定は0 ｡ Specifies the default wrap value for tags. Defaults to 0.
_________________________________________________________________

## 説明Description

このtable命令は2次元格子の欄を生成する｡表はデータ保存と取出しの為に､ Tcl 配列変数又は Tcl 命令を使用できる｡この部品は活性の欄を有する､その内容は校正可能である(状態が通常の場合)｡この部品は欄について無為設定の様式と複数の札を運営する､それは､行､列､欄の様式を変化する為に使用できる(詳細は TAGS 参照)｡欄の閃きは､変化した欄が指定された時間 ("瞬き")の量について色を変化することにより設定することができる｡欄は､ それぞれTAGS と ≪EMBEDDED WINDOWS≫内で記述された通り､映像や窓を埋め込ませることができる｡　　 The table command creates a 2-dimensional grid of cells. The table can use a Tcl array variable or Tcl command for data storage and retrieval. The widget has an active cell, the contents of which can be edited (when the state is normal). The widget supports a default style for the cells and also multiple tags, which can be used to change the style of a row, column or cell (see TAGS for details). A cell flash can be set up so that changed cells will change color for a specified amount of time ("blink"). Cells can have embedded images or windows, as described in TAGS and «EMBEDDED WINDOWS» respectively.

下に記述した様に一つ或いはそれ以上が選択できる｡もし表がその選択を輸送している場合( -exportselection を参照されたい)､選択を扱う為に､標準 X11 通信規格に従う｡詳細は THE SELECTION を参照されたい｡　 One or more cells may be selected as described below. If a table is exporting its selection (see -exportselection option), then it will observe the standard X11 protocols for handling the selection. See THE SELECTION for details.

表窓内に全ての欄が一度に表示される必要はない; 下に述べる命令は窓内の視野を変化する為に使用できる｡表は標準の -xscrollcommand 指定と -yscrollcommand 指定を使って両方向に巻上げできる｡又､下に述べるように走査も運営されている｡ It is not necessary for all the cells to be displayed in the table window at once; commands described below may be used to change the view in the window. Tables allow scrolling in both directions using the standard -xscrollcommand and -yscrollcommand options. They also support scanning, as described below.

良好な出来栄えを得る為に､この表は多数の描画様式を運営している､その内の２つは完全に Tk と互換性がある｡　 In order to obtain good performance, the table widget supports multiple drawing modes, two of which are fully Tk compatible.

## 初期化Initialization

表命令が解釈実行機能内に積込まれた時､組込み Tcl の tkTableInit が評価される｡これは積込むべき初期ファイルに束縛した適切な表を捜す｡ 捜索されるディレクトリーは､Tktable(version) が追記されるのとされないの両方 $tcl_pkgPath 内と､ $tk_library と [pwd] (現在のディレクトリー)である｡使用者はこの捜索リストに$env(TK_TABLE_LIBRARY) を追加できる｡無為設定では､捜索する為のファイルは tkTable.tcl を呼ばれるが､これは $env(TK_TABLE_LIBRARY_FILE)を設定することにより覆されことが可能である｡　　 When the table command is loaded into an interpreter, a built-in Tcl command, tkTableInit, is evaluated. This will search for the appropriate table binding init file to load. The directories searched are those in $tcl_pkgPath, both with Tktable(version) appended and without, $tk_library and [pwd] (the current directory). You can also define an $env(TK_TABLE_LIBRARY) to head this search list. By default, the file searched for is called tkTable.tcl, but this can be overridden by setting $env(TK_TABLE_LIBRARY_FILE).

この全体の初期記述譜は､外部函数が積込まれる前に､使用者自身のtkTableInit 手続き函数を提供することにより覆すことが可能である｡さもないと､前述の env(TK_TABLE_LIBRARY) 変数が $env(TK_TABLE_LIBRARY_FILE) が発見されたディレクトリーに設定される｡　　 This entire init script can be overridden by providing your own tkTableInit procedure before the library is loaded. Otherwise, the aforementioned env(TK_TABLE_LIBRARY) variable will be set with the directory in which $env(TK_TABLE_LIBRARY_FILE) was found.

## Indices

表の為の多くの部品命令は引数として一つ或いはそれ以上の番号を取る｡表の特定の欄を指定する番号は､次の方法のどれかである｡ Many of the widget commands for tables take one or more indices as arguments. An index specifies a particular cell of the table, in any of the following ways:

number,number
欄を行,列の数値番号として指定する､これは関連する Tcl 配列の番号に該当する､ここで -roworigin,-colorigin は表の最初の欄に相当する(無為設定では0,0 )｡ Specifies the cell as a numerical index of row,col which corresponds to the index of the associated Tcl array, where -roworigin,-colorigin corresponds to the first cell in the table (0,0 by default).

active
  局所遊走子を有する欄を指示す｡activate部品命令により指定される｡ Indicates the cell that has the location cursor. It is specified with the activate widget command.
anchor
  選択の錨点を指示す､それはselection anchor 部品命令により設定される｡ Indicates the anchor point for the selection, which is set with the selection anchor widget command.

bottomright 表内の可視の右下欄を指示す｡ bottomright Indicates the bottom-rightmost cell visible in the table.

end
  表の右下の欄を指示す｡　 Indicates the bottom right cell of the table.
origin
  表の左上の校正可能な欄を指示す､表示の中にある必要はない｡これは使用者が定める起点であって表題領域と看做される｡ Indicates the top-leftmost editable cell of the table, not necessarily in the display. This takes into account the user specified origin and title area.
topleft
  可視の表の頂最左の校正可能な欄を指示す(これは表題を含まない)｡ Indicates the top-leftmost editable cell visible in the table (this excludes title cells).
@x,y
  x と y (画素単位で)によって指示される表窓内の点が覆う欄を指示す｡ もしどの欄もその点を覆わない場合は､その点に最も近い欄が使われる｡　 Indicates the cell that covers the point in the table window specified by x and y (in pixel coordinates). If no cell covers that point, then the closest cell to that point is used.

下の部品命令記述の中で､最初と最後と名付けられた引数は常に一つ或いはそれ以上の上記形式の内の一つの文書番号を含む｡　 In the widget command descriptions below, arguments named index, first, and last always contain text indices in one of the above forms.

## 札 Tags

札は文書文字列であり､表内の零又はそれ以上の行､列､欄に関連付けされている｡ 札は任意の文字列を含んでも好いが､多分､命令の混乱を減らす為に､番号に見える名前を使うことを避けるのが最もよい｡ 表内には幾つの数の札があってもよいが､それぞれの行､列､欄は同時には唯一つの関連した札を有することができる｡ それぞれの表には幾つかの永久的な札があり､それは使用者によって構成設定可能であり､特定の欄について属性を定める｡ A tag is a textual string that is associated with zero or more rows, columns or cells in a table. Tags may contain arbitrary characters, but it is probably best to avoid using names which look like indices to reduce coding confusion. There may be any number of tags in a table, but each row, column or cell can only have one tag associated with it at a time. There are several permanent tags in each table that can be configured by the user and will determine the attributes for special cells:

active
  この札は活性な欄を与える｡　　 This tag is given to the active cell
flash
  もし瞬き様式が是の場合､この札はどれでも最近校正された欄を与える｡　 If flash mode is on, this tag is given to any recently edited cells.
sel
  この札は､どれか選択された欄を与える｡　 This tag is given to any selected cells.
title
  この札は表題行と列内のどれかの欄を与える｡この札は無為設定では-state 不能 を有する｡　 This tag is given to any cells in the title rows and columns. This tag has -state disabled by default.

札は画面上で欄が表示される方法を制御する｡ 適切な場合は､表示の欄の為の無為設定は表部品の為の設定によって定められる｡しかし､表示指示項目は``pathName tag configure'' 部品命令を使用して､個別の札に関連付けされているかもしれない｡ もし､欄か行か列が札貼りされていると､札に関連付けされた表示指示項目は無為設定表示様式を上書きする｡次の指示項目が現在札の為に運営されている｡ Tags control the way cells are displayed on the screen. Where appropriate, the default for displaying cells is determined by the options for the table widget. However, display options may be associated with individual tags using the ``pathName tag configure'' widget command. If a cell, row or column has been tagged, then the display options associated with the tag override the default display style. The following options are currently supported for tags:

-anchor anchor
  欄空間内の品目の為の錨｡　 Anchor for item in the cell space.
-background or -bg color
  欄の背景色｡　 Background color of the cell.
-borderwidth or -bd pixelList
  欄の縁の巾､表の為の書式と同じ､ただし､無為設定の表の縁巾値を相続する為に空であるかもしれない(無為設定)｡ Borderwidth of the cell, of the same format for the table, but may also be empty to inherit the default table borderwidth value (the default).
-font fontName
  欄内の文書の為の字母｡　 Font for text in the cell.
-foreground or -fg color
  欄の前景の色｡　 Foreground color of the cell.
-justify justify
  欄内の多行文書を如何に揃えるか｡left か right か center の内の一つでなければならない｡ How to justify multi-line text in a cell. It must be one of left, right, or center.
-image imageName
  文書の代わりに表示すべき映像｡　 An image to display in the cell instead of text.
-multiline boolean
  多行文書を改行付で表示するか｡　 Whether to display text with newlines on multiple lines.
-relief relief
  欄の立体感｡　 The relief for the cell.
-showtext boolean
  文書を映像に被せて表示するか｡　 Whether to show the text over an image.
-state state
  特定の欄について不能にすることを許容する為の欄の状態｡これはinsert やdelete 処理により校正されることを防ぐが､直接のset は抑制しない｡ The state of the cell, to allow for certain cells to be disabled. This prevents the cell from being edited by the insert or delete methods, but a direct set will not be prevented.
-wrap boolean
  巾が十分でない欄内で文字を折り返すか｡ Whether characters should wrap in a cell that is not wide enough.

札の間の優先順位は生成順序に基づいている(最初に生成された札が無為設定で最優先権を有する)､又､この順序は下に述べる札関連の幾つかの函数の実装にも使用される｡ 欄が表示されるとき､その特性は札によって定められ､その特性はそれが割当てられ多札によって定められる｡札の特性は､``pathName tag lower'' と ``pathName tag raise'' 部品命令によって修正可能である｡　 A priority order is defined among tags based on creation order (first created tag has highest default priority), and this order is used in implementing some of the tag-related functions described below. When a cell is displayed, its properties are determined by the tags which are assigned to it. The priority of a tag can be modified by the ``pathName tag lower'' and ``pathName tag raise'' widget commands.

もし欄がそれに関連付けされた幾つかの札を有する場合(譬ば､特定の行と欄札を伴う表題欄)､最も高い優先度の指定項目を有する札が使用される｡もし特定の表示指定項目が特定の札の為に指定されてないか､空文字列として指定されている場合､その指定項目は使われない；　次に最優先の札の指定項目が代わりに使われる｡もしどの札も特定の表示指定項目を指定されない場合､部品の為の無為設定の様式が使用される｡　 If a cell has several tags associated with it that define the same display options (eg - a title cell with specific row and cell tags), then the options of the highest priority tag are used. If a particular display option hasn't been specified for a particular tag, or if it is specified as an empty string, then that option will not be used; the next-highest-priority tag's option will be used instead. If no tag specifies a particular display option, then the default style for the widget will be used.

映像は表示目的のみに使用される｡その欄の中の校正は猶も可能であり､欄のどのような問合せも -showtext の値を考慮せずに､欄の文書値を示す｡ Images are used for display purposes only. Editing in that cell will still be enabled and any querying of the cell will show the text value of the cell, regardless of the value of -showtext.

## 埋め込み窓 Embedded Windows

表部品内には幾つの数でも埋め込み窓があり得る(欄につき一つ)､又､どの様な部品も埋め込み窓として使用できる(幾何管理譜の為の通常の規則の対象であり､それは､表窓に埋め込まれた窓の親かその親の子孫であることを要求する)｡画面内の埋め込まれた窓の位置は更新される､理由は､表は修正されるか巻上げられ､又､表部品の可視領域から入ったり出たりして移動するので対応付けされ､非対応付けされるので｡それぞれの埋め込み窓は表部品ないの一つの欄の大きさの価値を占有し､表内の欄の番号によって参照される｡表部品に関連付けされた窓は表部品が破壊された時に破壊される｡　 There may be any number of embedded windows in a table widget (one per cell), and any widget may be used as an embedded window (subject to the usual rules for geometry management, which require the table window to be the parent of the embedded window or a descendant of its parent). The embedded window's position on the screen will be updated as the table is modified or scrolled, and it will be mapped and unmapped as it moves into and out of the visible area of the table widget. Each embedded window occupies one cell's worth of space in the table widget, and it is referred to by the index of the cell in the table. Windows associated with the table widget are destroyed when the table widget is destroyed.

窓は表示の目的のみに使用される｡値は猶もその欄に実在するが窓が何かの方法で削除されるまで表示されない｡ もし窓が破壊されか他の幾何管理譜への表部品により失われるかするとそれに関連したどのようなデータも失われる(それが占有している欄は最早window names 内に現れない)｡ Windows are used for display purposes only. A value still exists for that cell, but will not be shown unless the window is deleted in some way. If the window is destroyed or lost by the table widget to another geometry manager, then any data associated with it is lost (the cell it occupied will no longer appear in window names).

埋め込み窓が窓部品に窓構成設定命令により追加された時､幾つかの構成設定指示項目はそれに関連付けされるかもしれない｡これらの指示項目は後に､窓の構成設定部品命令の呼出しで修正できる｡次の指示項目が現在運営されている｡　 When an embedded window is added to a table widget with the window configure widget command, several configuration options may be associated with it. These options may be modified with later calls to the window configure widget command. The following options are currently supported:

-create script
  現在の所運営されていない｡ NOT CURRENTLY SUPPORTED. Specifies a Tcl script that may be evaluated to create the window for the annotation. If no -window option has been specified for this cell then this script will be evaluated when the cell is about to be displayed on the screen. Script must create a window for the cell and return the name of that window as its result. If the cell's window should ever be deleted, the script will be evaluated again the next time the cell is displayed.
-background or -bg color
  欄の背景色｡もし指定されない場合､表の無為設定の背景色が使用される｡　 Background color of the cell. If not specified, it uses the table's default background.
-borderwidth or -bd pixelList
  欄の縁巾､表の為のものと同じ書式だが､無為設定の縁巾値を受け継ぐ為に空文字列でも好い｡(無為設定) Borderwidth of the cell, of the same format for the table, but may also be empty to inherit the default table borderwidth value (the default).
-padx pixels
  説明書頁内の Tk 指定に定義された通り｡　 As defined in the Tk options man page.
-pady pixels
  説明書頁内の Tk 指定に定義された通り｡　 As defined in the Tk options man page.
-relief relief
  その中に窓が置かれている欄の為に使われる立体感｡もし指定されない場合､表の無為設定の立体感が使われる｡ The relief to use for the cell in which the window lies. If not specified, it uses the table's default relief.
-sticky sticky
  欄の内部の窓の接着性､grid 命令によって定義された通り｡ Stickiness of the window inside the cell, as defined by the grid command.
-window pathName
  注釈内の表示への窓の名前を指定する｡ここで指定される前に実在せねばならない｡　 Specifies the name of a window to display in the annotation. It must exist before being specified here.

## 選択the Selection

表の選択は文字列の型の如く利用できる｡無為設定では､選択の値は､入れ子になったTclリスト形式内の選択された欄の値である､ここでそれぞれの行はリストでありそれぞれの列は行リストの要素である｡使用者は､ -rowseparator と -colseparator 指示項目の設定により解釈されているこの値を変えることができる｡譬ば､無為設定の Excel 書式を -rowseparator を ≪\n≫ に､又､ -colseparator を≪\t" に設定すべきであろう｡これらの値の変更は､表が選択を如何に送出すかと､貼り付けたデータを如何に読むか､及び､表が常に自身に切取り貼り付けが可能であるべきことが確実になるか､の両方に影響する｡如何に貼り付けが処理されているかの変更は表外部函数手続き tk_tablePasteHandler の校正により可能である｡これは -selectioncommand が設定されている場合､必要かもしれない｡　 Table selections are available as type STRING. By default, the value of the selection will be the values of the selected cells in nested Tcl list form where each row is a list and each column is an element of a row list. You can change the way this value is interpreted by setting the -rowseparator and -colseparator options. For example, default Excel format would be to set -rowseparator to «\n» and -colseparator to «\t". Changing these values affects both how the table sends out the selection and reads in pasted data, ensuring that the table should always be able to cut and paste to itself. It is possible to change how pastes are handled by editing the table library procedure tk_tablePasteHandler. This might be necessary if -selectioncommand is set.

## 行/列引伸ばし Row/Col Spanning

個別の欄は複数の行 及び/又は 列 を引伸ばすことができる｡ これは､spans 命令経由で実行される(正確な引数については下を参照)｡表題領域内の欄では､あの引伸ばしは表題領域を超えては許容されない､又､それに応じて拘束されている｡もし構成設定中に表題領域が収縮する場合､上記を確実にするために正常か否かの確認が生じる｡ 使用者は定義された行/列領域を超えて広げるように通常欄に延伸を設定できる｡ これらの引伸ばしは定義された行/列領域が広がる時に延伸がそれを拡張するかは考慮されない｡ Individual cells can span multiple rows and/or columns. This is done via the spans command (see below for exact arguments). Cells in the title area that span are not permitted to span beyond the title area, and will be constrained accordingly. If the title area shrinks during a configure, sanity checking will occur to ensure the above. You may set spans on regular cells that extend beyond the defined row/col area. These spans will not be constrained, so that when the defined row/col area expands, the span will expand with it.

延伸を設定する時､確認がされ､延伸が既に延伸されたり隠蔽されたりする欄に至っていないかを確認する｡ これは不都合であり許容されない｡延伸は表描画の全ての速度に影響するかもしれない､但し重要ではない｡ もし延伸が使われないと､出来栄えの損失はない｡　 When setting a span, checks are made as to whether the span would overlap an already spanning or hidden cell. This is an error and it not allowed. Spans can affect the overall speed of table drawing, although not significantly. If spans are not used, then there is no performance loss.

延伸欄により隠された欄は猶も妥当なデータを有する｡これは切取り貼り付け操作の間､若しくは､get や set のような命令により直接利用される間に見られる｡ Cells hidden by spanning cells still have valid data. This will be seen during cut and paste operations that involve hidden cells, or through direct access by a command like get or set.

拡張欄の描画特性は欄の可視領域のみに適用される｡譬ば､もし欄が 5 列を超えて欄が中央に整列されていると､これらの列のどの部分を見るときも可視領域内の中央に現れる｡不可視列領域は中央揃え計算では考慮されない｡ The drawing properties of spanning cells apply to only the visual area of the cell. For example, if a cell is center justified over 5 columns, then when viewing any portion of those columns, it will appear centered in the visible area. The non-visible column area will not be considered in the centering calculations.

## 命令置換Command Substitution

表が運営している､命令に基づく種々の指定項目は全て､ Tk 百分率置換模型を運営している｡ 次の百分率並びが表部品によって認識され置換される｡ The various option based commands that the table supports all support the familiar Tk %-substitution model (see bind for more details). The following %-sequences are recognized and substituted by the table widget:

%c
SelectionCommand については､選択内のどの行内の最大の列数｡それ以外では､起動された欄の列｡　 For SelectionCommand, it is the maximum number of columns in any row in the selection. Otherwise it is the column of the triggered cell.

%C
  %rと%cの為の置換の便益｡　 A convenience substitution for %r,%c.
%i
  SelectionCommand については､選択内の欄の総数｡Commandについては､ read (get) については 0 ､ write (set) については 1 ｡その他の場合､欄内の現在の遊走子の位置｡ For SelectionCommand, it is the total number of cells in the selection. For Command, it is 0 for a read (get) and 1 for a write (set). Otherwise it is the current cursor position in the cell.
%r
  SelectionCommandについては､選択内の列の数｡その他の場合､起動された欄の行｡ For SelectionCommand, it is the number of rows in the selection. Otherwise it is the row of the triggered cell.

%s
ValidateCommandについては､妥当性確認された欄の現在の値｡SelectionCommandについては､最後の活性欄の番号｡Commandについては､ reads (get) で空である､又 欄のwrites (set)の為の現在の値｡ For ValidateCommand, it is the current value of the cell being validated. For SelectionCommand, it is the default value of the selection. For BrowseCommand, it is the index of the last active cell. For Command, it is empty for reads (get) and the current value of the cell for writes (set).

%S
  ValidateCommand については､妥当性確認される欄の新しい値の可能性｡BrowseCommand については､新しい活性欄の為の番号｡　 For ValidateCommand, it is the potential new value of the cell being validated. For BrowseCommand, it is the index of the new active cell.

%W
命令が生成された窓への経路名｡　 The pathname to the window for which the command was generated.

## 部品命令Widget Command

table 命令は､その名前がpathNameである､新しい Tcl 命令を生成する｡ この命令は部品上に種々の操作を惹き起こす為に使われる｡それは次の一般書式を有する｡ The table command creates a new Tcl command whose name is pathName. This command may be used to invoke various operations on the widget. It has the following general form:
pathName option ?arg arg ...?
option と arg は命令の正確な振舞いを定める｡ Option and the args determine the exact behavior of the command.

次の命令がtable部品について可能である｡ The following commands are possible for table widgets:

pathName activate index
index によって指された欄を活性に設定する｡　 Sets the active cell to the one indicated by index.

pathName bbox first ?last?
指定された欄(領域)に関する束縛矩形を画素単位の x, y, 巾､高さの ４つ組として返す｡　 It returns the bounding box for the specified cell (range) as a 4-tuple of x, y, width and height in pixels. It clips the box to the visible portion, if any, otherwise an empty string is returned.

pathName border option args
この命令は表のための縁の寸法設定を実装する為に悪魔教の憑り付きである｡これは通常次の適正な指示と共に束縛を経由して呼ばれる｡　 This command is a voodoo hack to implement border sizing for tables. This is normally called through bindings, with the following as valid options:

pathName border mark x y ?row|col?
可能であれば､表窓内のその点の下にある x と y と 行 及び/又は 列境界 を記録する; 後に border dragto 命令と一緒に使われる｡典型的にはこの命令は部品内でのマウス釦押下と関連付けられる｡もし行か列が指定されないと､それは両方の境界番号の組の数を返す(空の品目は境界なしを意味する)｡そうでない場合､指定された品目が返される｡　 Records x and y and the row and/or column border under that point in the table window, if any; used in conjunction with later border dragto commands. Typically this command is associated with a mouse button press in the widget. If row or col is not specified, it returns a tuple of both border indices (an empty item means no border). Otherwise, just the specified item is returned.

pathName border dragto x y
この命令は､その x と y 引数と､その部品の為の最後の border mark 命令の x と y 引数との間の差を計算する｡ そしてその差により先に印し付けした境界を調整する｡この命令は典型的には部品内のマウス動作行事に関連付けされ､対話的な境界再寸法設定の効果を生成する｡　　 This command computes the difference between its x and y arguments and the x and y arguments to the last border mark command for the widget. It then adjusts the previously marked border by the difference. This command is typically associated with mouse motion events in the widget, to produce the effect of interactive border resizing.

pathName cget option
optionによって与えられる構成設定指示項目の現在の値を返す｡option はtable 命令によるどの様な値も受入れられる｡ Returns the current value of the configuration option given by option. Option may have any of the values accepted by the table command.

pathName clear option ?first? ?last?
この命令は表によって制御されら特定の状態情報を消去する為に便利な業務譜である｡ first と last は適正な表の位置番号である｡もしどれも指定されない場合､命令は表全体を操作する｡次の指定項目が認識される｡ This command is a convenience routine to clear certain state information managed by the table. first and last represent valid table indices. If neither are specified, then the command operates on the whole table. The following options are recognized:

pathName clear cache ?first? ?last?
表が高速記憶の指定された区間を有していれば解消する｡ Clears the specified section of the cache, if the table has been keeping one.

pathName clear sizes ?first? ?last?
指定された 高さ/巾 寸法の指定された行と列領域を解消する｡ 一つだけ番号指定された時､例えば2,0 では､行 2 と 列 0 として解釈する｡ Clears the specified row and column areas of specific height/width dimensions. When just one index is specified, for example 2,0, that is interpreted as row 2 and column 0.

pathName clear tags ?first? ?last?
札の指定された領域を解消する(全ての行､列､欄札)｡ Clears the specified area of tags (all row, column and cell tags).

pathName clear all ?first? ?last?
指定された領域上で上記全ての解消機能を遂行する｡　 Performs all of the above clear functions on the specified area.

pathName configure ?option? ?value option value ...?
部品の構成設定項目を問合せるか修正する｡もしoptionが何も指定されないと､path_Name について利用できる全ての指示項目を記述するリストを返す(このリストの書式の情報は Tk_ConfigureInfo を参照されたい)｡もしoptionが値なしで指定されると､命令は指示項目の名前の項目を記述するリストを返す(このリストはoptionが指定されない場合に返される値の仔リストに相当するものに等しい)｡ もし､一つ或いはそれ以上のoption-value対が指定されると､この命令は与えられた部品の指示項目を与えられた値に修正する； この場合､命令は空リストを返す｡option はtable命令によって受入れられるどの様な値でもよい｡ Query or modify the configuration options of the widget. If no option is specified, returns a list describing all of the available options for path_N ame (see Tk_ConfigureInfo for information on the format of this list). If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given widget option(s) to have the given value(s); in this case the command returns an empty string. Option may have any of the values accepted by the table command.

pathName curselection ?value?
引き数なしでは､現在選択されている欄の番号を並び揃えて返す｡さもないと､全ての選択された欄を与えられた値に設定する｡関連付けされたTcl配列がないか状態が不能の場合は､設定は効果を有さない｡ With no arguments, it returns the sorted indices of the currently selected cells. Otherwise it sets all the selected cells to the given value. The set has no effect if there is no associated Tcl array or the state is disabled.

pathName curvalue ?value?
もし値が与えられない場合､校正される欄(active によって指示される)の値が返される､そうでない場合､与えられた値が設定される｡　 If no value is given, the value of the cell being edited (indexed by active) is returned, else it is set to the given value.

pathName delete option arg ?arg?
この命令は表内の様々なことを削除することに使われる｡option によって､幾つかの形式がある｡ This command is used to delete various things in a table. It has several forms, depending on the option:

pathName delete active index ?index?
活性な欄から文書を削除する｡もし一つの番号しか与えられない場合､その番号の後ろの文字を削除する､それ以外では､第一の番号から二番目の番号までを削除する｡index は数値か､insert かend でも好い｡ Deletes text from the active cell. If only one index is given, it deletes the character after that index, otherwise it deletes from the first index to the second. index can be a number, insert or end.

pathName delete cols ?switches? index ?count?
列indexの箇所で始まる(そこも含んで)count個の列を削除する｡index は表の限界に制限される｡もしcountが負数の場合､左向けに列を削除する｡それ以外では､右側を削除する｡countは無為設定は 1 である(丁度その列を指すことを意味する)｡現在､この動作に伴う範囲は調整されない｡指定項目は次の通り｡ Deletes count cols starting at (and including) col index. The index will be constrained to the limits of the tables. If count is negative, it deletes cols to the left. Otherwise it deletes cols to the right. count defaults to 1 (meaning just the column specified). At the moment, spans are not adjusted with this action. Optional switches are:

-holddimensions
  表の列が削除により影響されないことを惹き起す(空欄が現れるかもしれない)｡無為設定では､countにより寸法は調整される｡ Causes the table cols to be unaffected by the deletion (empty cols may appear). By default the dimensions are adjusted by count.
-holdselection
  絶対欄値上に設定が維持されることを惹き起す｡指定しない場合､選択は解消される｡ Causes the selection to be maintained on the absolute cells values. Otherwise, the selection will be cleared..
-holdtags
  tag手段によって指定された札をデータに従って移動しないことを惹き起す｡又width手段によって設定された特定の巾が調整されることを防止する｡無為設定ではこれらの札は適切に調整される｡　 Causes the tags specified by the tag method to not move along with the data. Also prevents specific widths set by the width method from being adjusted. By default, these tags are properly adjusted.
-holdwindows
  window手段によって生成された埋め込み窓をデータに従って移動しないことを惹き起す｡無為設定では､これらの窓は､適当に調整される｡ Causes the embedded windows created with the window method to not move along with the data. By default, these windows are properly adjusted.
-keeptitles
  表題領域欄を変化から防止する｡指定なしの場合､通常欄と同じ様に扱われ指定に従って移動する｡ Prevents title area cells from being changed. Otherwise they are treated just like regular cells and will move as specified.
--
  指定項目の終わりを伝える｡ Signifies the end of the switches.

pathName delete rows ?switches? index ?count?
行indexの箇所で始まる(そこも含んで)count個の行を削除する｡もしcountが負数の場合､上向けに行を削除する｡それ以外では､した向けに行を削除する｡選択は解消される｡指示項目は列消去のものと同じである｡｡ Deletes count rows starting at (and including) row index. If count is negative, it deletes rows going up. Otherwise it deletes rows going down. The selection will be cleared. The switches are the same as those for column deletion.

pathName get first ?last?
リスト内の表の最初と最後(指定されれば)の参照により指定された欄の値を返す｡ Returns the value of the cells specified by the table indices first and (optionally) last in a list.

pathName height ?row? ?value row value ...?
もしrowが全く指定されない場合は､高さが設定された全ての列を記述するリストを返す｡もし値なしにrowが指定されると､その列の高さが文字単位(正数)又は画素単位(負数)で印刷される｡もし一つ或いはそれ以上のrow-value対が指定されると､それぞれの行にその高さが行単位(正数)又は画素単位(負数)で設定される｡もしvalueがdefaultであると､行は-rowheight により指定された､無為設定高さを使う｡ If no row is specified, returns a list describing all rows for which a height has been set. If row is specified with no value, it prints out the height of that row in characters (positive number) or pixels (negative number). If one or more row-value pairs are specified, then it sets each row to be that height in lines (positive number) or pixels (negative number). If value is default, then the row uses the default height, specified by -rowheight.

pathName hidden ?index? ?index ...?
もし引き数なしに呼出されると､全ての隠蔽された欄(拡張された欄によって変換された欄)を返す｡ 一つの番号が指定されるとその番号によって変換された拡張欄を返す｡もし複数の番号が指定されると､全ての欄がが隠蔽されていれば1､そうでない場合は0を返す｡　 When called without args, it returns all the hidden cells (those cells covered by a spanning cell). If one index is specified, it returns the spanning cell covering that index, if any. If multiple indices are specified, it returns 1 if all indices are hidden cells, 0 otherwise.

pathName icursor ?arg?
引き数なしでは､活性欄内の挿入遊走子の場所を印刷する｡引き数が１つの場合､遊走子を文字列内のその位置に設定する｡0 は最初の文字の前を指す､使用者は現在の挿入点又は文書の末尾としてinsertやend を使用することができる｡もし活性名欄がないか､欄や表が不能の場合､これは-1を返す｡　 With no arguments, prints out the location of the insertion cursor in the active cell. With one argument, sets the cursor to that point in the string. 0 is before the first character, you can also use insert or end for the current insertion point or the end of the text. If there is no active cell, or the cell or table is disabled, this will return -1.

pathName index index ?row|col?
形式 行,列 の形式の番号に相当する整数欄座標を返す｡もしrowかcolが指定されると､行又は列番号のみが返される｡　 Returns the integer cell coordinate that corresponds to index in the form row,col. If row or col is specified, then only the row or column index is returned.

pathName insert option arg arg
この命令は種々の事柄を表に使われる｡option に従って幾つかの形式がある｡ This command is used to into various things into a table. It has several forms, depending on the option:

pathName insert active index value
value は活性らのindex位置に挿入される文書文字列である｡遊走子は新しい文書の後ろに位置決めされる｡indexは番号か､insert か　end である｡　 The value is a text string which is inserted at the index postion of the active cell. The cursor is then positioned after the new text. index can be a number, insert or end.

pathName insert cols ?switches? index ?count?
indexの列から始まるcount列を挿入する｡もしcountが負数の場合､指定された列の前に挿入する｡それ以外の場合､指定された列の後に挿入する｡選択は解消される｡指定子は列削除のものと同じである｡　 Inserts count cols starting at col index. If count is negative, it inserts before the specified col. Otherwise it inserts after the specified col. The selection will be cleared. The switches are the same as those for column deletion.

pathName insert rows ?switches? index ?count?
indexの行から始まるcount行を挿入する｡もしcountが負数の場合､指定された行の前に挿入する｡それ以外の場合､指定された行の後に挿入する｡選択は解消される｡指定子は列削除のものと同じである｡　 Inserts count rows starting at row index. If count is negative, it inserts before the specified row. Otherwise it inserts after the specified row. The selection will be cleared. The switches are the same as those for column deletion.

pathName reread
欄の古い内容を再読みし校正緩衝域内に戻す｡校正を強制終了する為に <Escape> が押された時(無為設定)に鍵の束縛に便利である｡ Rereads the old contents of the cell back into the editing buffer. Useful for a key binding when <Escape> is pressed to abort the edit (a default binding).

pathName scan option args
この命令は表上で走査を実装する為に使われる｡optionによって二つの形式がある｡ This command is used to implement scanning on tables. It has two forms, depending on option:

pathName scan mark x y
x と y 及び表窓内の現在の可視域を記録する; 後にscan dragto 命令と一緒に使用される｡典型的には､この命令は部品内でのマウスボタン押下と関連付けられる｡これは空文字列を返す｡ Records x and y and the current view in the table window; used in conjunction with later scan dragto commands. Typically this command is associated with a mouse button press in the widget. It returns an empty string.

pathName scan dragto x y.
この命令は､その x と y 引数と､その部品の為の最後の scan mark 命令の x と y 引数との間の差を計算する｡ そして座標の差異の５倍によって視野を調整する｡この命令は典型的には部品内のマウス動作行事に関連付けされ､ 高速で窓を通り過ぎる時にリストを引き摺る効果を生成する｡返される値は空文字列である｡ This command computes the difference between its x and y arguments and the x and y arguments to the last scan mark command for the widget. It then adjusts the view by 5 times the difference in coordinates. This command is typically associated with mouse motion events in the widget, to produce the effect of dragging the list at high speed through the window. The return value is an empty string.

pathName see index
もし欄が現在画面上に可視でない場合､ 表内の視野を調節することにより与えられたindexが左頂上から一つ外れた欄(表題の行と列を除く)の位置になる｡ 実際の欄は画面全部を保持する為に異なるかもしれない｡ Adjust the view in the table so that the cell given by index is positioned as the cell one off from top left (excluding title rows and columns) if the cell is not currently visible on the screen. The actual cell may be different to keep the screen full.

pathName selection option arg
この命令は表内部の選択を調整する｡optionによって幾つかの形式がある｡　 This command is used to adjust the selection within a table. It has several forms, depending on option:

pathName selection anchor index
indexにより与えられた欄に選択錨を設定する｡選択錨は選択の末尾であり､マウスにより選択を引き摺り出す間､肯定される｡番号anchorは錨欄を参照する為に使用されるかもしれない｡ Sets the selection anchor to the cell given by index. The selection anchor is the end of the selection that is fixed while dragging out a selection with the mouse. The index anchor may be used to refer to the anchor cell.

pathName selection clear first ?last?
first と last の両方とその間の範囲のどれかの欄が選択された場合､それらは削除される｡この範囲の外の欄については選択の状態は変更されない｡ first はそこから全ての選択を削除する為にall として指定されることがあり得る｡　 If any of the cells between first and last (inclusive) are selected, they are deselected. The selection state is not changed for cells outside this range. first may be specified as all to remove the selection from all cells.

pathName selection includes index
indexによって認識される欄が現在選択されている場合 1 を返し､そうでない場合 0 を返す｡ Returns 1 if the cell indicated by index is currently selected, 0 if it isn't.

pathName selection set first ?last?
first と last の両方とその間の範囲の全ての欄を選択する､その範囲の外の欄の選択状態に影響を及ぼさない｡ Selects all of the cells in the range between first and last, inclusive, without affecting the selection state of cells outside that range.

pathName set ?row|col? index ?value? ?index value ...?
指定された番号を関連付けされた値に設定する｡表の妥当性はこの手段経由では起動されない｡もし行か列がindex/value対のリストに先行していると､その値はTclリストであると看做され､その値は分割されそれに従う列(もし行が指定されている場合)､或いは列(もし行が指定されている場合)の中に設定される｡譬ば､set row 2,3 {2,3 2,4 2,5} なら､ 2,3 から 2,5 迄､3 欄が設定される｡欄の設定は既知の表の次元により､警告なしに束縛される｡　 Sets the specified index to the associated value. Table validation will not be triggered via this method. If row or col precedes the list of index/value pairs, then the value is assumed to be a Tcl list whose values will be split and set into the subsequent columns (if row is specified) or rows (for col). For example, set row 2,3 {2,3 2,4 2,5} will set 3 cells, from 2,3 to 2,5. The setting of cells is silently bounded by the known table dimensions.

pathName spans ?index? ?rows,cols index rows,cols ...?
この命令は行/列範囲の操作に使用される｡引き数なしに呼出されると､全ての既知範囲が {index span}の形式の数列のリストとして返される｡ index のみを伴って呼出されると､そのindexに関する範囲のみが返される｡それ以外の場合､偶数の index rows,cols 対が範囲の設定に使用される｡範囲はindexに始まり､行と列の指定された個数について継続する｡負数の範囲は運営されていない｡0,0 の範囲はその欄のどの範囲も解消する｡更なる情報はEXAMPLESの項を参照されたい｡　　 This command is used to manipulate row/col spans. When called with no arguments, all known spans are returned as a list of tuples of the form {index span}. When called with only the index, the span for that index only is returned, if any. Otherwise an even number of index rows,cols pairs are used to set spans. A span starts at the index and continues for the specified number of rows and cols. Negative spans are not supported. A span of 0,0 unsets any span on that cell. See EXAMPLES for more info.

pathName tag option ?arg arg ...?
この命令は札の操作に使用される｡命令の正確な振る舞いはtag引き数に続く option 引き数に依存する｡ それは､cget とcell と､未知の札名を愚痴る row|col である｡ この命令では次の書式が現在運営されている｡　　 This command is used to manipulate tags. The exact behavior of the command depends on the option argument that follows the tag argument. cget, cell, and row|col complain about unknown tag names. The following forms of the command are currently supported:

pathName tag cell tagName ?index ...?
引き数なしの場合､札を使う列のリストを印刷する｡ 引き数ありの場合､以前この手段を使って使用されたかもしれないどの札かを置き換え名前付けられた札を使う為に指定された欄を設定する｡ tagNameが {} の場合､欄は無為設定の札を使う為に解消される｡-*tagcommand 評価の間に追加された札はここでは登録されない｡もしtagNameが実在しない場合､無為設定指示項目では生成される｡ ｡ With no arguments, prints out the list of cells that use the tag. Otherwise it sets the specified cells to use the named tag, replacing any tag that may have been set using this method before. If tagName is {}, the cells are reset to the default tag. Tags added during -*tagcommand evaluation do not register here. If tagName does not exist, it will be created with the default options.

pathName tag cget tagName option
この命令はtagNameによって与えられた札に関連付けされたoptionの名前の項目の値を返す｡option はtag configure 部品命令によって受け入れられるどの様な値でもよい｡ This command returns the current value of the option named option associated with the tag given by tagName. Option may have any of the values accepted by the tag configure widget command.

pathName tag col tagName ?col ...?
引き数なしの場合､札を使う列のリストを印刷する｡ 引き数ありの場合､以前この手段を使って使用されたかもしれないどの札かを置き換え名前付けられた札を使う為に指定された列を設定する｡ tagNameが {} の場合､列は無為設定の札を使う為に解消される｡-coltagcommand 評価の間に追加された札はここでは登録されない｡もしtagNameが実在しない場合､無為設定指示項目では生成される｡ ｡ With no arguments, prints out the list of cols that use the tag. Otherwise it sets the specified columns to use the named tag, replacing any tag that may have been set using this method before. If tagName is {}, the cols are reset to the default tag. Tags added during -coltagcommand evaluation do not register here. If tagName does not exist, it will be created with the default options.

pathName tag configure tagName ?option? ?value? ?option value ...?
この命令は､表部品全体の為の修正された指示項目の代わりにtagNameによって与えられた札に関連付けられる指示項目を修正することを除いて構成設定部品命令に似ている｡もしどの項目も指定されない場合､この命令はtagNameに関する利用可能な全ての項目を記述するリストを返す(このリストの書式に関する情報はTk_ConfigureInfoを参照されたい)｡もし値を伴わずに項目が指定されると､この命令は名前付けた項目を記述するリストを返す(このリストは､項目が全く指定されずに返された値のに相当する仔リストに等しい)｡もし､一つ或いはそれ以上のoption-value対が指定された場合､この命令は､与えられた項目がtagName 内の与えられた値を有するよう修正する｡この場合この命令は空文字列を返す｡札に関して利用できる項目の詳細は上述のTAGSの項目を参照されたい｡　 This command is similar to the configure widget command except that it modifies options associated with the tag given by tagName instead of modifying options for the overall table widget. If no option is specified, the command returns a list describing all of the available options for tagName (see Tk_ConfigureInfo for information on the format of this list). If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given option(s) to have the given value(s) in tagName; in this case the command returns an empty string. See TAGS above for details on the options available for tags.

pathName tag delete tagName
札を削除する｡札が実在しない場合も不都合にはならない｡　 Deletes a tag. No error if the tag does not exist.

pathName tag exists tagName
名前つけれられた札が実在すると 1 ､それ以外は0を返す｡ Returns 1 if the named tag exists, 0 otherwise.

pathName tag includes tagName index
指定された札が名前の札であれば1､そうでなければ0を返す｡ Returns 1 if the specified index has the named tag, 0 otherwise.

pathName tag lower tagName ?belowThis?
名前付けられた札の優先順位を降げる｡もし belowThis が指定されない場合､tag の優先順位は底に降げられる､指定された場合､belowThis の一つ下に降げられる｡　 Lower the priority of the named tag. If belowThis is not specified, then the tag's priority is lowered to the bottom, otherwise it is lowered to one below belowThis.

pathName tag names ?pattern?
もし紋様が指定されていない場合､全ての定義された札の名前が示される｡指定された場合､patternは展開形式紋様としてその紋様に合致する札のみを示す為に使われる｡札名前は優先順位の順に返される(高優先札が始め)｡ If no pattern is specified, shows the names of all defined tags. Otherwise the pattern is used as a glob pattern to show only tags matching that pattern. Tag names are returned in priority order (highest priority tag first).

pathName tag raise tagName ?aboveThis?
名前付けられた札の優先順位を揚げる｡もしaboveThis が指定されない場合､tag の優先順位は頂上に揚げられる､指定された場合､aboveThis の一つ上に揚げられる｡　 Raise the priority of the named tag. If aboveThis is not specified, then the tag's priority is raised to the top, otherwise it is raised to one above aboveThis.

pathName tag row tagName ?row ...?
もし引き数なしの場合､札を使う列のリストを印刷する｡ 引き数ありの場合､以前この手段を使って使用されたかもしれないどの札かを置き換え名前付けられた札を使う為に指定された列を設定する｡ tagNameが {} の場合､行は無為設定の札を使う為に解消される｡-rowtagcommand 評価の間に追加された札はここでは登録されない｡もしtagNameが実在しない場合､無為設定指示項目では生成される｡ ｡ With no arguments, prints out the list of rows that use the tag. Otherwise it sets the specified columns to use the named tag, replacing any tag that may have been set using this method before. If tagName is {}, the rows are reset to use the default tag. Tags added during -rowtagcommand evaluation do not register here. If tagName does not exist, it will be created with the default options.

pathName validate index
現在の-validatecommandに基づいて指定された番号を明示的に妥当性確認し欄が妥当か否かで 0 か 1 を返す｡ Explicitly validates the specified index based on the current -validatecommand and returns 0 or 1 based on whether the cell was validated.

pathName width ?col? ?value col value ...?
もし col が全く指定されない場合は､巾が設定された全ての行を記述するリストを返す｡ もし値なしにcolが指定されると､その列の巾が文字単位(正数)又は画素単位(負数)で印刷される｡もし一つ或いはそれ以上のcol-value対が指定されると､それぞれの列にその巾が文字単位(正数)又は画素単位(負数)で設定される｡もしvalueがdefaultであると､列は-colwidth により指定された､無為設定巾を使う｡ If no col is specified, returns a list describing all cols for which a width has been set. If col is specified with no value, it prints out the width of that col in characters (positive number) or pixels (negative number). If one or more col-value pairs are specified, then it sets each col to be that width in characters (positive number) or pixels (negative number). If value is default, then the col uses the default width, specified by -colwidth.

pathName window option ?arg arg ...?
この命令は埋め込み窓の操作に使われる｡ 正確な命令の振舞いはwindow引き数に続くoption引き数に依存する｡ この命令の次の形式が現在運営されている｡ This command is used to manipulate embedded windows. The exact behavior of the command depends on the option argument that follows the window argument. The following forms of the command are currently supported:

pathName window cget index option
この命令はindexにより与えられた窓に関連付けされた項目に名前付けされた項目の現在の値を返す｡ optionはwindow configure 部品命令に受け入れられたどの値でもよい｡　 This command returns the current value of the option named option associated with the window given by index. Option may have any of the values accepted by the window configure widget command.

pathName window configure index ?option? ?value? ?option value ...?
この命令は､表部品全体の為の修正指示項目の代わりに､与えられたindexの 埋め込み窓に関連付けられた指示項目を修正する事を除き､構成設定部品命令に似ている｡もし項目が指定されない場合､この命令はその番号のために利用可能な全ての項目を記述したリストを返す(このリストの書式の情報については Tk_ConfigureInfo を参照されたい)｡もし項目が値なしに指定された場合､この命令は名前付けされた項目を記述するリストを返す(このリストは､項目指定なしの場合に買えさっる値の該当する仔リストに相当するものに等しい)｡もし一つ或いはそれ以上のoption-value対が指定されると､この命令はindexにより与えられた項目が与えられた値を有する様修正する､この場合｡命令は空文字列を返す｡この窓に利用できる項目の詳細は上記EMBEDDED WINDOWSを参照されたい｡　 This command is similar to the configure widget command except that it modifies options associated with the embedded window given by index instead of modifying options for the overall table widget. If no option is specified, the command returns a list describing all of the available options for index (see Tk_ConfigureInfo for information on the format of this list). If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given option(s) to have the given value(s) in index; in this case the command returns an empty string. See EMBEDDED WINDOWS above for details on the options available for windows.

pathName window delete index ?index ...?
表から埋め込み窓を削除する｡関連付けされた窓も同様に削除される｡ Deletes an embedded window from the table. The associated window will also be deleted.

pathName window move indexFrom indexTo
埋め込まれた窓を一つ別に移動する｡もし窓が目的欄に既に実在する場合､それが削除される｡ Moves an embedded window from one cell to another. If a window already exists in the target cell, it will be deleted.

pathName window names ?pattern?
もし指示紋様が指定されない場合､埋め込まれた窓の全ての欄が表示される｡指示された場合､そのpatternはその紋様に合致した欄のみが表示される為の展開紋様として使用される｡ If no pattern is specified, shows the cells of all embedded windows. Otherwise the pat_tern is used as a glob pattern to show only cells matching that pattern.

pathName xview args
この命令は部品の窓内の情報の水平位置の問合せと変更に使用される｡それは次のどれかの形式をとる｡ This command is used to query and change the horizontal position of the information in the widget's window. It can take any of the following forms:

pathName xview
二つの要素を含むリストを返す｡それぞれの要素は0と1の間の実少数である｡共にそれらは窓内の可視域の水平広がりを記述する｡譬えば､もし第一要素が .2 で第二要素が .6 の場合､ 表の文書の20%が左の画面外にあり表文書の中央の40%が窓内の可視域であり､40%が右側の画面外である｡これらは-xscrollcommand指示項目を経由して巻上げ帯に渡される値と同じである｡ Returns a list containing two elements. Each element is a real fraction between 0 and 1; together they describe the horizontal span that is visible in the window. For example, if the first element is .2 and the second element is .6, 20% of the table's text is off-screen to the left, the middle 40% is visible in the window, and 40% of the text is off-screen to the right. These are the same values passed to scrollbars via the -xscrollcommand option.

pathName xview index
窓の可視域を調整し､indexにより与えられた列が窓の左縁に表示されるようにする｡ Adjusts the view in the window so that the column given by index is displayed at the left edge of the window.

pathName xview moveto fraction
窓内の可視域を調整し表文書の全体の巾の少数が左の画面外になる｡fractionは0と1の間の少数でなければならない｡　 Adjusts the view in the window so that frac_tion of the total width of the table text is off-screen to the left. fraction must be a fraction between 0 and 1.

pathName xview scroll number what
この命令は窓内の可視域を number か what に従って右や左に調整する｡number は整数でなければならない｡what はunits か pages かこれらの内の一つのものの省略形でなければならない｡もし what が units の場合､可視域は number 文字単位(0 文字の巾)に表示上を右か左に調整する｡もしpagesである場合､可視域は number 画面巾で調整する｡もしnumberが負数の場合､更に左の文字が可視になる､整数の場合更に右の文字が可視になる｡　 This command shifts the view in the window left or right according to number and what. Number must be an integer. What must be either units or pages or an abbreviation of one of these. If what is units, the view adjusts left or right by number character units (the width of the 0 character) on the display; if it is pages then the view adjusts by number screenfuls. If number is negative then characters farther to the left become visible; if it is positive then characters farther to the right become visible.

pathName yview ?args?
この命令は部品の窓内の文書の縦方向位置を問合せしたり変更したりする｡次のどれかの形式をとる｡ This command is used to query and change the vertical position of the text in the widget's window. It can take any of the following forms:

pathName yview
二つの要素からなるリストを返す､その両方は 0 から 1 の間の実少数である｡ 最初の要素は窓の頂上の表要素の位置を与える､全体としての表に対する相対値である(譬えば､ 0.5 は表を通して半分を意味する)｡ 第二の要素は､窓内の最後のものの丁度直ぐ後ろの表要素の位置を与える､全体としての表の相対値である｡ これらは-yscrollcommand 指定を経由して巻き上げ帯に渡されるものと同じ値である｡ Returns a list containing two elements, both of which are real fractions between 0 and 1. The first element gives the position of the table element at the top of the window, relative to the table as a whole (0.5 means it is halfway through the table, for example). The second element gives the position of the table element just after the last one in the window, relative to the table as a whole. These are the same values passed to scrollbars via the -yscrollcommand option.

pathName yview index
窓の中の可視域を調整し､index により与えられた業が窓の頂上に表示される様にする｡　 Adjusts the view in the window so that the row given by index is displayed at the top of the window.

pathName yview moveto fraction
窓の可視域を調整して少数によって与えられた要素が窓の頂上に現れるようにする｡少数は 0 と 1 との間の少数である､ 0 は表の最初の要素を指し示す､ 0.33 は表の三分の一の要素を指し示す､以下同様である｡ Adjusts the view in the window so that the element given by fraction appears at the top of the window. Fraction is a fraction between 0 and 1; 0 indicates the first element in the table, 0.33 indicates the element one-third the way through the table, and so on.

pathName yview scroll number what
この命令は窓内の可視域を number か what に従って上や下に調整する｡number は整数でなければならない｡what はunits か pages でなければならない｡もし what が units の場合､可視域は number 行単位に上か下に調整する｡もしpagesである場合､可視域は number 画面巾で調整する｡もしnumberが負数の場合､初めの要素が可視になる､整数の場合後ろの要素が可視になる｡　 This command adjusts the view in the window up or down according to number and what. Number must be an integer. What must be either units or pages. If what is units, the view adjusts up or down by number lines; if it is pages then the view adjusts by num_ber screenfuls. If number is negative then earlier elements become visible; if it is positive then later elements become visible.

## 無為設定束縛Default Bindings

初期化は束縛の級を生成しそれは次の無為設定の振る舞いを与える｡　 The initialization creates class bindings that give the following default behaviour:

[1]
  欄内での釦-1 の軽叩はその欄を活性化する｡既に活性化された欄内の軽叩は挿入遊走子を最もマウスに近い文字に移動する｡ Clicking Button-1 in a cell activates that cell. Clicking into an already active cell moves the insertion cursor to the character nearest the mouse.
[2]
  釦-1 を押下したままの移動は選択領域を払い出す｡釦-1 の押下中に出ると､表の選択に沿って走査が起こることを惹き起す｡　 Moving the mouse while Button-1 is pressed will stroke out a selection area. Exiting while Button-1 is pressed causing scanning to occur on the table along with selection.
[3]
  釦-2 を押下したままの移動は､どの選択もなしに走査が起こることを惹き起す｡　 Moving the mouse while Button-2 is pressed causes scanning to occur without any selection.
[4]
  Home moves the table to have the origin in view.
[5]
  End moves the table to have the end cell in view.
[6]
  Ctrl-Home は表を根元に移動しその欄を活性化する Control-Home moves the table to the origin and activates that cell.
[7]
  Ctrl-End は表を末尾に移動しその欄を活性化する｡　 Control-End moves the table to the end and activates that cell.
[8]
  Shift-Ctrl-Home は選択を根元に広げる｡　 Shift-Control-Home extends the selection to the origin.
[9]
  Shift-Ctrl-End は選択を末尾に広げる｡ Shift-Control-End extends the selection to the end.
[10]
  左､右､上､下向きの矢は活性欄を移動する｡　 The left, right, up and down arrows move the active cell.

[11] Shift-<矢> はその方向に選択を広げる｡ Shift-<arrow> extends the selection in that direction.

[12] Ctrl-左向き矢と 右向き矢 欄内の挿入遊走子を移動する｡ Control-leftarrow and Control-rightarrow move the insertion cursor within the cell.

[13]
  Ctrl-斜線 は全欄を選択する｡ Control-slash selects all the cells.

[14] Ctrl-逆斜線 は全ての欄から選択を解消する｡　 Control-backslash clears selection from all the cells.

[15] Backspace は活性欄の挿入遊走子の前の文字を削除する｡ Backspace deletes the character before the insertion cursor in the active cell.

[16] Del は活性欄の挿入遊走子の後ろの文字を削除する｡　 Delete deletes the character after the insertion cursor in the active cell.

[17] Esc は､その欄に遂行されたどの様な校正も破棄して､指定されたデータ源資から活性欄の値を再読取りする｡ Escape rereads the value of the active cell from the specified data source, discarding any edits that have may been performed on the cell.

[18] Ctrl-a は活性欄の初めに挿入遊走子を移動する｡　 Control-a moves the insertion cursor to the beginning of the active cell.

[19] Ctrl-e は活性欄の末尾に挿入遊走子を移動する｡　 Control-e moves the insertion cursor to the end of the active cell.

[20] Ctrl-- と Ctrl-= はその中にある活性欄の列の巾を減少と増加する｡ Control-minus and Control-equals decrease and increase the width of the column with the active cell in it.

[21] 境界上にある時の､釦-3 (Windowsでは右釦)を押下したままの移動は､-resizeborders の値に基づいて､対話的な 行 及び/又は 列 の再寸法設定が起こることを惹き起す｡ Moving the mouse while Button-3 (the right button on Windows) is pressed while you are over a border will cause interactive resizing of that row and/or column to occur, based on the value of -resizeborders.

幾つかの束縛は部品の-selectionmodeに従って幾らか異なる振る舞いを有するかもしれない｡ Some bindings may have slightly different behavior dependent on the -selectionmode of the widget.

もし-state指示項目を使用して部品が不能である場合､その可視域は猶も調整されえるし､欄は猶も選択されているが､挿入遊走子は表示されないし如何なる欄の修正も行われない｡　 If the widget is disabled using the -state option, then its view can still be adjusted and cells can still be selected, but no insertion cursor will be displayed and no cell modifications will take place.

表の振る舞いは 個別の部品の為の新しい束縛の定義又は､級の束縛の再定義により変化するかもしれない｡ 無為設定束縛は実装時に組み込まれるか «[lindex $tcl_pkgPath 0]/Tktable<version>/tkTable.tcl" に相当するとして期待されるファイルから読込まれる｡ The behavior of tables can be changed by defining new bindings for individual widgets or by redefining the class bindings. The default bindings are either compiled in or read from a file expected to correspond to: «[lindex $tcl_pkgPath 0]/Tktable<version>/tkTable.tcl".

## 出来栄えの問題Performance Issues

行と列又は表部品の数は､再描画の速度に深刻には影響しない｡ 表媒介変数と欄の再計算と再描画は可能な限り抑制されている｡　 The number of rows and columns or a table widget should not significantly affect the speed of redraw. Recalculation and redraw of table parameters and cells is restricted as much as possible.

挿入遊走子のある欄の表示は毎回遊走子が瞬く毎に再描画され､画像通信の決まった並びを惹き起こす｡これを避けるには-insertofftime指示項目を 0 に設定されたい｡高速記憶域なしのtableの-commandの使用は重大な遅延を惹き起こすかもしれない､理由は､欄値のそれぞれの要求ごとに命令が呼ばれるから｡ The display cell with the insert cursor is redrawn each time the cursor blinks, which causes a steady stream of graphics traffic. Set the -insertofftime option to 0 avoid this. The use of a -command with the table without a cache can cause significant slow-down, as the command is called once for each request of a cell value.

## 用例　Examples

左上隅表題領域を一つの広がった欄にする｡これは行と列の両方を一つの範囲に過大評価するが､この命令は全ての制約を使用者に課す｡ Set the topleft title area to be one spanning cell. This overestimates both row and column span by one, but the command does all the constraining for us.
$table span [$table cget -roworigin],[$table cget -colorigin] [$table cget -titlerows],[$table cget -titlecols]
表窓を強制的に刷新する(表内の不都合が適切な刷新を惹き起さない不具合の様な僅かな機会に対しては便利である)｡ Force a table window refresh (useful for the slight chance that a bug in the table is not causing proper refresh):
$table configure -padx [$table cget -padx]

## 用語Keywords

table, widget, extension

Table of Contents

- Name
- Synopsis
- Standard Options
- Widget-specific Options
- Description
- Initialization
- Indices
- Tags
- Embedded Windows
- the Selection
- Row/Col Spanning
- Command Substitution
- Widget Command
- Default Bindings
- Performance Issues
- Examples
- Keywords