# mkWidgets 1.3 Manual, Part 2 of 2

###### [訳註：源文が公式であり和訳は目安に過ぎない]
この算譜とその説明文を､どの様な目的にも､無料で､使用する事と､複写する事と､修正する事と､配布する事の許諾をここに認める｡著者は､どの様な目的に関しても､この算譜の適切性について､表明しない｡これは"あるがまま"で､明示的及び暗示的保障なしに提供される｡ この算譜の使用によって､その様な使用によって生じる損失に関する､どの様な要求や債務からも､著者が､免責され､且つ､保護される事に､使用者は同意する事になる｡
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted. The author makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. By use of this software the user agrees to indemnify and hold harmless the author from any claims or liability for loss arising out of such use.

## 目次 CONTENTS

mkWidgets 1.3 -高次部品を記述する方法､及び､それらの蒐集｡第1部: 高次部品の構築方法(第2部) mkWidgets 1.3 - A method for writing metawidgets, and a collection of these. Part 2: My metawidget collection (Part 1)

Introduction
Aclock
Calendar
Combobox
Document
Gridcontrol
Ibutton
Iconbox
Listcontrol
Pane
Progressbar
Scrollbox
Spinentry
Statusbar
Tabcontrol
Textframe
Toolbar
Tooltip
Treecontrol
Window
Author

## 緒論 INTRODUCTION

次の節は､ mkWidgets拡張に伴う高次部品の蒐集 の取扱説明書である｡ mkWidgets拡張は､主に､高次部品を定める手段method､ 即ち､ 任意の個数の通常TK標準部品から構成される 合成部品､である｡ 含まれる高次部品の集積は､ しかし､ GUI設計者の 必要性と望みの大半を既に覆う筈である｡ それは結局､大量の役務である ;) The following sections are the man pages for the metawidget collection that comes with the mkWidgets extension. The mkWidgets extension is primarily a method for defining metawidgets, i.e. compound widgets that consist of an arbitrary number of regular TK standard widgets. The included metawidget collection, however, should already cover most of the needs and wishes of GUI designers. It was a lot of work, after all ;)

特に､述べる値打ちがあるのは 複雑な､高次部品､格子制御､樹枝状制御､リスト制御､アイコン箱である｡ それらは､ 上手く､如何に標準文書部品が実際に 存在するかを 例示する｡ この連鎖を Windowsと Linuxに関する画像に連結されたい｡ Particularly worth to mention are the complex metawidgets gridcontrol, treecontrol, listcontrol and iconbox. They demonstrate nicely how powerful the standard text widget can actually be. Follow these links to screenshots for Windows and Linux.

全ての高次部品は､命令cget と configureを理解する｡ 又､それぞれの高次部品の中に正確に 一個の標準部品があり､ それは､初期設定部品と呼ばれる｡ その全ての意味は､ 高次部品の定義の部分として 明示的でなく実装される 全ての命令と指示項目は､ 再指示される｡ Every metawidget understands the commands cget and configure. Also, in each metawidget there is exactly one standard widget that is called the default widget. All it means is that all options and commands not explicitely implemented as part of the metawidget definiton are redirected to it.

その結果､ 高次部品は､ 初期設定の部品が理解する 全ての指示項目と命令を理解する｡ 譬えば､もし､初期設定の部品が単純な枠であると､ 高次部品は､ -relief 指示項目を理解するが､ -font 指示項目はそうではない( -font 指示項目が高次部品そのものの部分として定義され実装されてない限り) ｡ これらの初期設定部品指示項目と命令は ここには記述されないが､ 寧ろ､ Tcl/Tk取説内に見られる｡ Consequently, a metawidget understands all options and commands that the default widget understands. E.g. if the default widget is a simple frame, then the metawidget will understand the -relief option, but not the -font option (unless the -font option is defined and implemented as part of the metawidget itself) . These default widget options and commands are not described here but can rather be found in the Tcl/Tk man pages.

更に､ 標準部品とは対照的に 高次部品に適用される制限 を理解することが重要である｡ どうか､ これらの詳細と 如何に高次部品が metawidget命令を伴って 作られたかの情報 について 取扱説明書のPart 1を を参照されたい｡ In addition, it is also important to understand the limitations that apply to metawidgets as opposed to standard widgets. Please see Part 1 of this manual for details on these and for information about how metawidgets are built with the metawidget command.

## Aclock

### 名称 Name

aclock - "アナログ時計"高次部品 An "analog clock" metawidget

### 説明 Description

aclock 高次部品は時針と分針を伴うアナログ時計に似ている｡ 針は鼠遊走子により引張れる｡時計は､又､二つの矢印釦と時刻記入欄により設定できる｡ 釦と時刻入力欄の間の灰色の領域の二重軽叩きは現在の時刻を設定する｡ The aclock metawidget resembles an analog clock, with an hour and a minute pointer. The pointers can be dragged with the mouse. The clock can also be set with two arrow buttons and a time entry field. A double-click on the gray area between the buttons and the time entry field sets the current time.

### 初期設定 Default

初期設定の部品は型画布canvasと､ 時計の絵画的要素､指示物の様なものである｡ 高次部品は､ この部品型の､ 全ての命令と構成設定指示項目を受入れる｡ The default widget is of type canvas and displays the clock's graphical elements, such as the pointers. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-controls top|bottom
時計の制御要素の位置を指定する｡ 制御要素は二つの矢印釦と時刻入力欄である｡ それらは時計の､上か下になり得る｡ Specifies the location of the control elements of the clock. The control elements are the two arrow buttons and the time entry field. They can be either above or below the clock.

-format format-string
標準的clock format命令に似た書式文字列を受入れる｡ 書式文字列は､入力欄に表示される時刻の方法を制御する｡ 又､get部品命令は 書式指示項目に沿った時刻を返す｡ Accepts a format string like for the standard clock format command. The format string controls the way the time is displayed in the entry field. Also, the get widget command returns the time according to the format option.

-font font-spec
標準的-font指示項目に似た､ 字母指定を受入れる｡ この指示項目は時刻入力欄に適用される｡ Accepts a font specification like for the standard -font option. This options is applied to the time entry field.

### 命令 Commands

set ?time-string?
時計の時刻を設定する｡ もし､時刻文字列が与えられないと､現在の時刻が採られ､ 文字列は標準のclock scan命令に受入れられる書式でなければならない｡ Sets the time of the clock. If no time-string is given, the current time is taken. the string must be in a format acceptable to the standard clock scan command.

get
時計が設定されている時刻を､ -format指示項目によって指定された書式で､ 返す｡ Returns the time the clock is set to, in the format specified by the -format option.

scroll minutes
時計の時刻を指定された分に従って前か后に設定する｡ Sets the clock's time forward or backward according to the specified minutes.

bind bind-arguments
標準的bind命令と同じだが､ 時計の時刻入力欄への束縛の適用を除く｡ Same as the standard bind command, except that it applies bindings to the clock's time entry field.

## Calendar

### 名称 Name

calendar - 暦高次部品 A calendar metawidget

### 説明 Description

calendar 高次部品は､ 鼠遊走子や文字鍵盤を使って日取りの選択を許容する暦を提供する｡ 使用者は遊走子鍵を使って日取りと週を通過して巻上られ､且つ､二つの矢印釦と制御鍵により､ 月と年を通過できる｡ 表示欄の日取り上での 二重-軽叩は現在の日取りを設定する｡ The calendar metawidget provides a calendar that allows for selection of a date by using the mouse or the keyboard. The user can scroll through the days and weeks by using the cursor keys, and through the month and years with two arrow buttons and the control key. A double-click on the date display field sets the current day.

### 初期設定 Default

初期設定の部品はtext型で､ 暦の日を表示する｡ 高次譜品は､部品型の 全ての命令と､構成設定指示項目を受容れる｡ The default widget is of type text and displays the calendar's days. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-controls top|bottom
時計の要素の制御の位置を指定する｡ 制御要素は二つの矢印釦と日取り表示欄である｡ それらは､時計の上か下になり得る｡ Specifies the location of the control elements of the clock. The control elements are the two arrow buttons and the date display field. They can be either above or below the clock.

-font font-spec
標準的-font指示項目用に似て 字母指定を受容れる｡ この指示項目は､ 暦内部と､日付表示欄に適用される｡ Accepts a font specification like for the standard -font option. This options is applied to the calendar interior and the date display field.

### Commands

set ?date-string?
暦の日取りを設定する｡ もし､日付文字列が何も与えられないと､現在の日取りが採られる｡ 文字列は標準clock scan命令に受容れられる書式でなければならない｡ Sets the date of the calendar. If no date-string is given, the current date is taken. the string must be in a format acceptable to the standard clock scan command.

get ?format-string?
暦が設定されている日取りを 指定された書式文字列を使って 返す｡ 後者は､指定なしでは､初期設定の %m/%d/%Y になる｡ 書式文字列は標準clock format命令に受容れられねばならない｡ Returns the date the calendar is set to, using an optional format string. The latter defaults to %m/%d/%Y, if not specified. The format string must be acceptable to the standard clock format command.

scroll integer ?days|months|years?
指定された整数値と単位に従って暦の日付を前や後ろに設定する｡ 指定されなければ､後者は初期設定で月になる｡ Sets the calendar's date forward or backward according to the specified integer value and unit. The latter defaults to months, if not specified.

bind bind-arguments
標準のbindと同じ､但し､暦の内部の束縛に提供されることを除く｡ Same as the standard bind command, except that it applies bindings to the calendar's interior.

headerconfig option-value pairs
全ての 指示項目-値 対を 週日名を表している 暦の冒頭行に適用する｡ 文字部品張札に適用可能な全ての指示項目を受容れる｡ Applies all option-value pairs to the calendar's headline, showing the weekdays. Accepts all options that can be applied to a text widget tag.

headercget option
暦の､ 週日名を表している 冒頭行の値を取出す｡ 文字部品張札に適用可能な全ての指示項目を受容れる｡ Retrieves an option value of the calendar's headline, showing the weekdays. Accepts all options that can be applied to a text widget tag.

## Combobox

### 名称 Name

combobox - 引出しメニュウを伴う入力部品､An entry widget with a pull-down menu, a.k.a. "combobox"

### 説明 Description

combobox 高次部品は､入力部品とリスト箱の組合せである｡ どの様な文書も入力部品に入れられる､だけでなく､ 引出しリストから､幾つもの既挿入値の内の一つを選択できる｡ このリストは､何時であれ､入力部品の右側の釦上を使用者が軽叩する時､現れる｡ 更に､ 何時であれ焦点が入力部品内にある時､ 遊走子鍵がリストを通して､巻上できる｡ The combobox metawidget is a combination of an entry widget and a listbox. One can enter any text into the entry widget but also select one of several predefined values from a pull-down list. This list appears whenever the user clicks on the button on the right side of the entry widget. In addition, the cursor keys can be used to scroll through the list whenever the focus is in the entry widget.

### 初期設定 Default

entry型の初期設定部品｡それは入力欄そのもの｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is of type entry. It is the entry field itself. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-lines integer
リスト内で表示される行の個数を指定する｡ Specifies the number of lines to be displayed in the list.

-entries arg arg ...
表示される値をリスト内に設定する｡ Sets the values to be displayed in the list.

-state normal|disabled|restricted
通常の entry の -state 指示項目に似ている｡ 制限様式では､コンボ箱はリストからの選択のみを許容する｡ Similar to the -state option of a regular entry widget. In restricted mode, the combobox does only allow selection from the list.

-command command-string
何時であれ､リストから新しい値が取出される時､指定された命令-文字列を実行する｡ Executes the specified command-string whenever a new value is picked from the list.

### 命令 Commands

see ?index?
indexによって指定される､引出しメニュから特定の値を設定する｡ もし､ index が提供されないと､現在の値の索引が返される｡ もし､値がリストの部分でない場合､代わりに -1 が返される｡ Sets a particular value from the pull-down menu, specified by index. If index is not provided, the index of the current value is returned. If this value is not part of the list, -1 is returned instead.

## Document

### 名称 Name

document - "多重 文書 対話機能-の様なもの "A "multiple document interface"-like thing

### 説明 Description

Windows上で､MDI(多重文書対話機能)は応用の為の身近な概念であり､ 同時に幾つもの書類を開けさせられる(譬えば､ワープロ)｡ ディスクトップ全体に それぞれの開いた書類が自己の窓を表示するのではなく､ 文書類は､ 応用譜の主窓内部のみを動き回れる"仔窓"内に整頓される｡ On Windows, MDI is a popular concept for applications that can have several documents open at a time (e.g. a word processor). Instead of each open document being displayed in its own window on the desktop, the documents are organized in "sub-windows" that can only be moved around within the application's main window.
document 高次部品は､この振舞に似ている｡ 他の部品は､文書窓内部で､最頂水準窓内と同じ様に､packや, plac や grid されることができる｡ 本文書窓は､寸法変更､最小化､最大化､動き回り､閉窓できる｡ 級機能 Arrange は､ frameにもなる､ その親窓内部の全ての文書窓の整頓に使うことができる｡ The document metawidget resembles this behavior. Other widgets can be packed, placed or gridded inside a document window like in a toplevel window. The document windows can be resized, minimized, maximized, moved around and, of course, closed. The class function Arrange can be used to arrange all document windows inside their parent window, which should be a frame.

### 初期設定 Default

初期設定部品は型 frameである｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is of type frame. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-title string
表題帯内に表示される表題を設定する｡ Sets the title to be displayed in the title bar.

-image image-name
文書窓の表題帯内に表示されるアイコンを指定する｡ Specifies an icon to be displayed in the document window's title bar.

-icontext string
文書窓がアイコン化される時に使われる表題文書を設定する｡ Sets the title text to be used when the document window is iconfied.

-x|-y|-width|-height pixels
これら四つの指示項目は､ 親窓内部の文書窓の位置と寸法を制御する｡ These four options control position and size of the document window within its parent window.

-font font-spec
文書窓の表題帯の字母を設定する｡ Sets the font for the document window's title bar.

-foreground|-background color
活動している窓の為に､ 表題帯の前景色と背景色を制御する｡ For the active window, controls the foreground and background color for the title bar.

-state normal|minimized|maximized|withdrawn
文書窓を､四つの可能な状態の内の一つに変換する｡ withdrawn のstate は､文書窓は隠れるが実際には削除されてない事を意味する｡ Transforms the document window into one of four possible states. The withdrawn state means that the document window disappears but is not actually deleted.

-minsize {width height}
文書窓の最小の巾と高さを制御する｡追加引数は､二つの整数を伴う､適切なtclリストでなければならない｡ Controls the minimum width and height for a document window. The option argument must be a proper tcl list with two integers.

### 命令 Commands

menu options
引き摺り-下しメニューを修正する､ 即ち､ アイコン上で軽叩された時､ 書類窓のアイコンを跳出す｡ options は､ 標準 menu 部品が受容れる 全ての指示項目－値対でありえる｡ この命令は､メニューに 参入 追加､又は無効 を許容する｡ Modifies the pull-down menu that pops up below the document window's icon, when clicked on the icon. The options can be all option-value pairs that the standard menu widget accepts. This command allows to add or disable entries to the menu.

lower|raise
書類窓は下敷きである､即ち､ それぞれ､ 全ての他の窓の後ろに置くか､又は､上に置く､即ち､最頂の､活動窓にする｡ The document window is lowered, i.e. put behind all other windows, or raised respectively, i.e., made the topmost, active window.

pack|grid|place widget args
他の部品を書類窓の内部に置くことを許容する｡ -fill both -expand 1 によって単純な枠内部に詰込 むこと､ そして､ 他の全ての窓を､この枠の内側に､ 標準的な､ packと, grid と place 命令によって 入れること を推奨する ｡ Allows for putting other widgets inside the document window. It is recommended to pack a simple frame inside with -fill both -expand 1 and then put all other windows inside this frame by means of the standard pack, grid and place commands.

Arrange horizontally|vertically|cascade|tile|icons|maximize|minimize
全ての書類窓を与えられた假引数に沿って整える｡Arrange icons は､ 窓よりもアイコンを整える｡ これは､級-函数であり､従って､ 書式 ::Document::Arrange mode で､呼出されるべきである｡ Arranges all document windows according to the given parameter. Arrange icons will arrange the icons rather than the windows. This is a class-function and hence has to be called in the format ::Document::Arrange mode

## Gridcontrol

### 名称 Name

gridcontrol - 表計算紙､又は表部品 A spreadsheed, or table widget.

### 説明 Description

gridcontrol 高次部品は､幾分複雑な部品であり､そして､ 表書式の､ 行と列の内のデータを表示することに使える｡ 列は､名前で､行は番号で､ 指定される｡ 選択は通常の方法に対応している｡小部屋と小部屋範囲は文書部品内の文書に似て､張札できる｡ 張札を構成設定することにより､小部屋はその色や､字母や､その他を変更できる｡ 列は､適切な文書切詰めにより寸法変更され得る｡ The gridcontrol metawidget is a rather complex widget and can be used to display data in rows and columns, hence in table format. Columns are addressed by name, rows by number. Selection is supported in the regular way. Cells and cell ranges can be tagged similar to text in a text widget. By configuring the tags, cells can change their color, font etc. Columns can be resized with proper text clipping.
幾つかの命令は小部屋や小部屋範囲の指定を要する｡ これは､書式 column-name.row-numberによりなされる｡ 譬えば､ salary.4 は salary 列の第四行内の小部屋を指定する｡万能切札も許容される : lastname.* は lastname列の全ての小部屋を指定する､ *.12 は12列の全ての小部屋である｡ その結果､ *.* は､表全体を識別する｡ Some commands require to specify a cell or a cell range. This is done in the format column-name.row-number. E.g. salary.4 specifies the cell in the fourth row of the salary column. Wildcard are also allowed: lastname.* specifies all cells of the column lastname, *.12 all cells of row 12. Consequently, *.* identifies the entire table.
全体の部品は､ 指定される列の数を考慮することなく､ 僅か三つの､文書部品に基づいている ｡ The entire widget is based on only three text widgets, regardless of the number of columns specified.

### 初期設定 Default

初期設定の部品は､部品の内部領域､及び､ textの型である｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is the widget's interior area and is of type text. The metawidget accepts all commands and configuration options of this widget type.

### Options

-font font-spec
列と行冒頭部を含む､格子制御の字母を設定する｡ 個別の列や列範囲の為の字母は､tag 命令の方法で制御できる(下記参照)｡ Sets the font of the gridcontrol, including the column and row headers. The font for individual cells or cell ranges can be controlled by means of the tag command. (see below).

-update full|partial|none
寸法変更操作の間に､如何に列が最新化されるかを制御する｡ none は､引き摺り中に列冒頭部を寸法変更するのみｖ｡ partial は､列を寸法変更するが､刈取りはしない､ full は､冒頭部と列の両方を､寸法変更し､足切りする｡ Controls how a column is updated during a resize operation. none only resizes the column header during dragging, partial resizes the column, too, but does not perform clipping, full resizes and clips both the header and the column.

-selectmode single|multiple
選択様式を設定する｡それが､ singleであると､一つだけの小部屋が選択できる｡ multiple 様式では､小部屋と小部屋範囲とが､ 列又は行冒頭の上での軽叩で､ 或いは､シフト鍵とコントロール鍵と鼠の組合せにより､選択され得る｡ Sets the select mode. If it is single, only one cell can be selected. In multiple mode, cells and cell ranges can be selected by clicking on column or row headers, or by using the shift and control key in combination with the mouse.

-onselect command-string
command-string が空でければ､選択が変更される度に評価される｡ If command-string is not empty, then it is evaluated each time the selection changes.

### 命令 Commands

column insert|delete|configure|cget|fit|bind|names|exists ?args?
この命令は､事柄に関連する全ての列を扱う｡ 列は､唯一の名前で識別され､そして､幾つかの構成設定指示項目を有す｡ This command handles all column related matters. Columns are identified by a unique name and have several configuration options.
column insert column-name position ?options? は指定された位置(非負の整数､又は "end")に新しい列を挿入する｡更に､構成設定指示項目が渡せる｡ column delete column-name は指定された列を削除する｡ column insert column-name position ?options? inserts a new column at the specified position (a non-negative integer, or "end"). In addition, configuration options can be passed. column delete column-name deletes the specified column.
column configure column-name ?options? は列を構成設定する｡三つの特別な指示項目がある : -width pixels は列の幅を指定する｡ -align left|right|center|numeric は列内の文書の並び方を制御する｡ -text string は列冒頭部を指定する｡ 文書部品張札が受容れられると､他の､全ての指示項目が受容れられる｡ column cget column-name option は与えられた指示項目の値を返す｡ column configure column-name ?options? configures a column. There are three special options: -width pixels specifies the column's width. -align left|right|center|numeric controls the alignment of text inside the column. -text string specifies the column heading. Otherwise, all options are accepted that a text widget tag would accept. column cget column-name option returns the value of the given option.
column fit column-name は､その列の全ての値が刈込み無しに表示され得る様に列を寸法変更する｡ column bind column-name ?bind-args? は bind命令の様に引数を受容れる｡ それらは直接､列冒頭部に渡される｡ 最後に､ column names は現在､定義されている全ての列を返し､ そして､ column exists column-name は列が存在すると1をそうでなければ0を返す｡ column fit column-name resizes a column so that all values of that columns can be displayed without being clipped. column bind column-name ?bind-args? accepts arguments like the bind command. They are passed directly to the column header. Finally, column names returns a list of all currently defined columns, and column exists column-name returns 1 if a column exists, 0 otherwise.

insert row-number ?value-list ...?
指定された列番号に､一つ或いは幾つかの列を挿入する､そして､値を満たす｡ それぞれの valueList は､列全体の為の値を含まねばならない､そして､ それで､ 指定された列と同じ数の要素を有する｡ 列-番号は､文字列"end"になり得る｡ Inserts one or more rows, starting at the specified row number, and fill them up with values. Each valueList must contain the values for an entire row and hence have the same number of elements as columns specified. Row-number can be the string "end".

delete from-row ?to-row?
列又は､列の範囲を削除する｡ 文字列 "end" は最後の列を意味する事に使われる｡ Deletes a row or a range of rows. The string "end" can be used to denote the last row.

set cell-spec ?value-list ...?
格子の内部の値を設定する｡ cell-spec は､ その値が置換えられる､ 小部屋範囲の左頂隅 の 小部屋を､指定する｡ 譬えば､ set Salary.5 80000 は､ 5 から 80000 行の Salary 列内の値を設定する｡ set Monday.3 {71 75 79} {58 65 61} は､ ２行を伴う､3列の矩形領域を設定する｡ 左頂の小部屋はMonday.3 であり､そして､ 71に設定される｡ 全ての週日の為の列があると､仮定すると､Wednesday.4 は 61に設定される｡ Sets values inside the grid. cell-spec specifies a cell that represents the top left corner of the cell range whos values are to be replaced. E.g. set Salary.5 80000 sets the value in the Salary column in row 5 to 80000. set Monday.3 {71 75 79} {58 65 61} sets a rectangular area of 3 columns by 2 rows. The top left cell is Monday.3 and is set to 71. Assumed there is a column for every weekday, then Wednesday.4 is set to 61.

get ?cell-spec1? ?cell-spec2?
小部屋､又は小部屋の範囲を返す｡ cell-spec1 は､矩形の形の格子領域の､左頂隅､ cell-spec2 は､矩形の形の格子領域の右底隅を指定する｡ その領域の値は､リストとして返され､ そこでは､それぞれの要素は､列を表し､且つ､ それは､ その列の値を伴うリストそのものである｡ もし､どの小部屋の規格も指定されないと､格子全体の内容が返される｡ 上記用例の中で､get Tuesday.3 Wednesday.4 は {{75 79} {65 61}} を返す｡ Returns the values of a cell or a range of cells. cell-spec1 specifies the top left corner, cell-spec2 the bottom right corner of a rectangular-shaped grid area. The values of that area are returned as a list, where each element represents a row and is itself a list with the values of that row. If neither cell-spec is specified, the entire grid contents is returned. In the above example, get Tuesday.3 Wednesday.4 returns {{75 79} {65 61}}.

tag add|delete|remove|cget|configure|lower|raise|ranges|names|bind ?args?
この命令は､小部屋と小部屋範囲に張札を適用し制御することを許容する｡ これは､ 張札 元々の文書部品内で使用する方法と､よく似ている｡ 小部屋は一つ或いはそれ以上の､ 　名前で識別される張札､ を有し得る｡ それぞれの張札は､構成設定できる､譬えば､ この特定の張札を有する全ての小部屋にこの色を順に適用できる､ 特定の背景色｡ This command allows to apply and control tags for cells and cell ranges. This is very similar to the way tags are used in the original text widget. Cells can have one or more tags, which are identified by a name. Each tag can be configured, e.g. with a certain background color, which in turn would apply this color to all cells that have this particular tag.
tag add tag-name cell-spec1 ?cell-spec2? は､張札名によって指定される張札を､ cell-spec1 (and cell-spec2).によって指定される小部屋(範囲)に追加する｡ tag remove tag-name cell-spec1 ?cell-spec2? は以前に追加された張札を小部屋や小部屋範囲から､取去る｡ tag names cell-spec は小部屋に張付けられた全ての張札を返す｡もし､小部屋範囲が指定されていると､最初の小部屋が採られる｡ tag ranges tag-name は指定された張札が現在張付けられている全ての小部屋を返す｡ 他の全ての張札命令は､文書部品の為の張札命令に正確に似て働く｡ 特に､選択は特別の張札"sel"を使って設定する事ができる｡ tag add tag-name cell-spec1 ?cell-spec2? adds the tag specified by tag-name to the cell (range) specified by cell-spec1 (and cell-spec2). tag remove tag-name cell-spec1 ?cell-spec2? removes a previously added tag from a cell or a cell range. tag names cell-spec returns all tags attached to a single cell. If a cell range is specified, the first cell is taken. tag ranges tag-name returns all cells that have the specified tag currently attached. All other tag commands work exactly like the tag commands for the text widget. In particular, the selection can be set by using the special tag "sel".

bind bind-arguments
集計用紙への束縛引数を直接適用する｡ 列と行の冒頭部は束縛を受容れない｡ Applies bind arguments directly to the spreadsheet. The column and row headers do not accept bindings.

see cell-spec
特定の小部屋が視界の外の場合に可視にする｡ Makes a particular cell visible, if it out of sight.

rows
行の総数を返す｡ Returns the total number of rows.

## Ibutton

### 名称 Name

ibutton - 映像を伴った釦 A button with an image

### 説明 Description

ibutton高次部品は､通常の釦に似ているが､その中に映像を有すことができることが､違っている｡ The ibutton metawidget is just like a regular button, except it can have an image inside it.

### 初期設定 Default

初期設定部品は通常の釦 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is a regular button. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-image image-name
表示される映像を指定する｡ Specifies the image to be displayed.

### 命令Commands

なし (none)

## Iconbox

### Name

iconbox - アイコンの為の容器 A container widget for icons

### 説明 Description

iconbox高次部品はアイコンの為の容器として働く｡ アイコンは､ 映像と､名札とから構成され､そして､通常幾つかの対象を表す(譬えば､ファイル)｡ 従って､又､それぞれのアイコンの為の､属性が表示される｡ 三つの異なる利用可能な眺望がある: 大型アイコンと､小型アイコンと､リスト視野｡ 後者のみが属性を表示する｡ アイコンへの束縛は行事上の呼戻し記述譜を許容する｡ The iconbox metawidget acts as a container for icons. An icon consists of an image and a label and usually represent some object (e.g. a file). Hence, attributes can also be displayed for each icon. There are three different views available: Large icons, small icons, and list view. Only the latter one would display the attributes. Bindings for the icons allow for callback scripts on events.

### 初期設定 Default

初期設定の部品はアイコン箱の内部領域にあり､text型である｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is the inner area of the iconbox and is of type text. The metawidget accepts all commands and configuration options of this widget type.

### Options

-font font-spec
アイコンの名札の為に使われる字母を設定する｡ Sets the font that is used for the label of the icons.

-update full|partial|none
リスト視野の時､寸法変更操作の間に如何に列が最新化されるかを制御する｡ none は､引き摺りの間､列冒頭の寸法変更のみ､ partial も､列を寸法変更するが､足切を遂行しない､ full は､ 引き摺りの間､ 寸法変更と足切の両方を冒頭部と列に､行う｡ When in list view, controls how a column is updated during a resize operation. none only resizes the column header during dragging, partial resizes the column, too, but does not perform clipping, full resizes and clips both the header and the column while dragging.

-selectmode single|multiple
選択様式を設定する｡もし､それが singleであると､一つだけのアイコンが選択される｡ multiple 様式では､ 鼠と組合せて､ シフト鍵とコントロール鍵を使って､ 一つより多くのアイコンが選択できる Sets the select mode. If it is single, only one icon can be selected. In multiple mode, more than one icon can be selected by using the shift and control key in combination with the mouse.

-onselect command-string
もし､command-string が空でなければ､選択変更の度にそれが評価される｡ If command-string is not empty, then it is evaluated each time the selection changes.

-view large|small|list
アイコン箱の表示様式を設定する: 大型アイコン､小型アイコン､リスト視野｡ リスト視野の為に､列冒頭行が現れ､アイコン属性が表示される｡ Sets the display mode for the iconbox: Large icons, small icons, and list view. For list view, a column header row appears and the icon attributes are displayed.

-columns column-spec-list
アイコン箱がリスト視野の時､アイコン属性を如何に表示するかを指定する｡ リスト内の､ それぞれの列指示は､それ自身､４つの要素迄を含む適切なリストでなければならない: 見出しと､配置と､巾と､最小巾｡見出しは必須であり､他は任意である｡ 配置は､ l (左)か､r (右)か, c (中央)か､ n (数値)の内の一つで 指定される｡ 巾と最小巾は画素単位で指定される｡ Specifies how to display icon attributes when the iconbox is in list view. Each column specification in the list must itself be a proper list containing up to 4 elements: Caption, alignment, width and minimal width. The caption is mandatory, the others are optional. An alignmentis specified by one of l (left), r (right), c (center) or n (numeric). Width and minimal is be specified in pixels.

### 命令 Commands

insert position icon-name ?options?
指定された位置(整数､又は"end")に新しいアイコンが挿入される｡ アイコンは､その名前で参照され､それはアイコン箱内で唯一でなければならない｡ アイコンは指示項目の指示項目値-値対により構成設定される(下記iconconfigure参照)｡ Inserts a new icon at the specified position (an integer, or "end"). Icons are referenced by their name, which must be unique for the iconbox. The icon is configured with optional option-value pairs (see iconconfigure below).

delete ?icon-name ...?
アイコン箱から一つ或いはそれ以上のアイコンを削除する｡もし､アイコンの名前が与えられないと､全てのアイコンが削除される｡ Deletes one or more icons from the iconbox. If no icon names are given, then all icons are deleted.

iconconfigure icon-name option value ?option value ...?
アイコンを構成設定する｡アイコン特有の指示項目は次の通り
-text string: アイコンに使われる名札
-image image-name: "large icons" 視野の中で使われる映像
-smallimage image-name: "small icons" とリストの視野で使われる映像
-values list: リスト視野の時に表示される属性
-user user-data: 任意の使用者データ｡アイコンに伴い保存されるが使用されることはない
他の全ての指示項目はアイコンの名札に適用される (-font, -bg etc.)
Configures an icon. Icon specific options are
-text string: The label to be used for the icon
-image image-name: The image to be used when in "large icons" view
-smallimage image-name: The image to be used when in "small icons" and list view
-values list: The attributes to be displayed when in list view
-user user-data: Arbitrary user data. Just stored with the icon but never used
All other options are applied to the icon's label (-font, -bg etc.).

iconcget icon-name option
指示項目の値を返す｡受容れる指示項目については､上記を参照｡ Returns an option value. For accepted options, see above.

iconbind icon-name bind-arguments
アイコンに関する束縛記述譜を定める｡ 更なる情報については､ 一般の bind 取説頁を参照されたい｡ これは､第一に､鼠行事､譬えば､二重-軽叩の為に､使われる､ 他方､鍵行事は､ bind 高次部品命令を使って定義される､ (アイコンは､ それは二つの名札で構成されるので､焦点を持てない｡従って､それは鍵行事を生成しない)｡ Defines a binding script for an icon. See the generic bind man page for more information. This is used primarily for mouse events, e.g. double-clicks, whereas key events are defined using the bind metawidget command (an icon cannot have the focus, since it consists of just two labels. Therefore it does not generate key events).

selection clear|get|set ?icon-names-list?
選択を制御する｡clear は選択を解消する､set icon-names-list は 指定されたアイコンの為に選択を設定する､get は､ 現在選択されている全てのアイコンのリストを返す｡ Controls the selection. clear clears the selection, set icon-names-list sets the selections for the specified icons, get returns a list of all icons that are currently selected.

sort ?-column column-caption? ?lsort-options?
名札､又は､ -columns 指示項目による設定通りの捕捉により指定された特定の列､ に沿って､ アイコンを､並び揃える｡ 更に､ lsort 命令によって受容れられる指示項目も使用できる｡ Sorts the icons, either by their label or by a particular column, specified by its caption as set with the -columns option. In addition, the options accepted by the lsort command can be used.

see icon-name
もし､視界の外にあるとアイコンを可視化する｡ Makes an icon visible if it is out of sight.

bind bind-arguments
標準的 bind と同じ､但し､ アイコン箱(文書部品)への束縛適用を除く｡ Same as the standard bind command, except that it applies bindings to the iconbox (a text widget).

size
アイコン箱内のアイコンの個数を返す｡ Returns the number of icons in the iconbox.

names
全てのアイコン箱内の名前のリストを返す｡ Returns a list with the names of all icons in the iconbox.

## Listcontrol

### 名称 Name

listcontrol - 拡張されたリスト箱型部品 An enhanced listbox type widget

### 説明 Description

listcontrol 高次部品は､多数列のリスト箱である｡ 列は､引張りにより寸法変更され得る｡ アイコンがそれぞれの列のそれぞれの行に個別に置ける｡ 列や列範囲は､ gridcontrol 部品に似て､張札できる｡ 張札を構成設定する事により､列はその色､字母､等を変更できる｡ 列は､ column-name.row-number により指定できる｡ 譬えば､ salary.4 は､ salary 列の四番目内の行内の小部屋を指定する｡ 共通札も許容される: lastname.* は､ lastname 列の全ての小部屋を､ *.12 は列12の全ての小部屋を､ 指定する｡ 結局､ *.* は全体のリスト制御を識別する｡ The listcontrol metawidget is a multicolumn listbox. Columns can be resized by dragging them. An icon can be placed into each column for each row individually. Cells or cell ranges can be tagged similar like with the gridcontrol widget. By configuring the tags, cells can change their color, font etc. A cell is specified with column-name.row-number. E.g. salary.4 specifies the cell in the fourth row of the salary column. Wildcard are also allowed: lastname.* specifies all cells of the column lastname, *.12 all cells of row 12. Consequently, *.* identifies the entire listcontrol.
全体の部品は､ 指定される列の個数に関係なく､ 二つの文書部品のみに基いている｡ The entire widget is based on only two text widgets, regardless of the number of columns specified.

### Default

高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is the widget's interior area and is of type text. The metawidget accepts all commands and configuration options of this widget type.

### Options

-font font-spec
列冒頭部も含めて､ リスト制御の字母を設定する｡ 個別の行の字母について､ tag 命令を用いて制御できる(下記参照)｡ Sets the font of the listcontrol, including the column headers. The font for individual rows can be controlled by means of the tag command. (see below).

-update full|partial|none
列が如何に､ 寸法変更操作の間に､ 最新化されるかを制御する｡ noneは､引摺りの間に､列冒頭部の寸法変更のみ行う､ partial は列を寸法変更するが､足切はしない､ full は､冒頭部と列の両方を寸法変更し､足切りする｡ Controls how a column is updated during a resize operation. none only resizes the column header during dragging, partial resizes the column, too, but does not perform clipping, full resizes and clips both the header and the column.

-selectmode single|multiple
選択様式を設定する｡もし､それがsingleの場合､一つの列だけが選択される｡ multiple 様式では､ 鼠と組合せてシフト鍵とCtrl鍵を使って､幾つかの行が選択できる｡ Sets the select mode. If it is single, only one row can be selected. In multiple mode, several rows can be selected by using the shift and control key in combination with the mouse.

-onselect command-string
もし､command-string が空でなければ､選択を変更する度にそれが評価される｡ If command-string is not empty, then it is evaluated each time the selection changes.

### 命令 Commands

column insert|delete|configure|cget|fit|bind|names|exists ?args?
この命令は全て､列に関連する事柄を扱う｡ 列は唯一の名前により識別され､且つ､幾つかの構成設定指示項目を有す｡ This command handles all column related matters. Columns are identified by a unique name and have several configuration options.
column insert column-name position ?options? は指定された位置 (非負の整数､又は"end") に､ 新しい列を挿入する｡更に､構成設定指示項目を渡すことができる｡ column delete column-name は指定された列を削除する｡
column configure column-name ?options? は列を構成設定する｡ そこには四つの特別指示項目がある: -width pixels は列の巾を指定する｡ -align left|right|center|numeric は列の内部の文書の並び方を制御する｡ -text string は列の冒頭を指定する｡ -minsize pixels は列の最小巾を指定する｡ それ以外､全ての指示項目は 文書部品張札が受容れる様な､全ての指示項目を受容れる｡ column cget column-name option は与えられた指示項目の値を返す｡
column fit column-name は､その列の全ての値を､ 切詰めなしに､表示できる様に､ 列寸法を変更する｡ column bind column-name ?bind-args? は bind 命令の様に､ 引数を受容れる｡それらは､直接列冒頭部に渡される｡ 最後に､ column names は､現在定義された全ての列のリストを返し､そして､ column exists column-name は､もし列が存在すると1､そうでなければ､0を返す｡
column insert column-name position ?options? inserts a new column at the specified position (a non-negative integer, or "end"). In addition, configuration options can be passed. column delete column-name deletes the specified column.
column configure column-name ?options? configures a column. There are four special options: -width pixels specifies the column's width. -align left|right|center|numeric controls the alignment of text inside the column. -text string specifies the column heading. -minsize pixels specifies the column's minimal width. Otherwise, all options are accepted that a text widget tag would accept. column cget column-name option returns the value of the given option.
column fit column-name resizes a column so that all values of that columns can be displayed without being clipped. column bind column-name ?bind-args? accepts arguments like the bind command. They are passed directly to the column header. Finally, column names returns a list of all currently defined columns, and column exists column-name returns 1 if a column exists, 0 otherwise.

insert row-number ?value-list ...?
指定された行番号から始めて､ 一つ或いはそれ以上の行を挿入する､ そして､それらに値を積む｡ それぞれのvalueListは､全部の行の為の値を含まねばならず､ 且つ､それで､指定された列と同じ数の､要素を有さねばならない｡ Inserts one or more rows, starting at the specified row number, and fill them up with values. Each valueList must contain the values for an entire row and hence have the same number of elements as columns specified. Row-number can be the string "end".

delete from-row ?to-row?
列又は列の範囲を削除する｡ 文字列"end"は最後の列を示す為に使用できる｡ Deletes a row or a range of rows. The string "end" can be used to denote the last row.

set ?-columns column-list? start-row ?value-list ...?
一つ或いはそれ以上の列の為の値を設定する｡もし､ -columns 指示項目が､指定されていると､ 特定の列の為の値のみ設定される｡ 列は､ 列特性 -textにより指定される事により､ 見出し で特定される｡ Sets new values for one or more rows. If the -columns option is specified, only the values for certain columns will be set. Columns are addressed by their caption as specified with the column property -text.

get ?-columns column-list? first-row ?last-row?
列又は列の範囲の値を返す｡ もし､-columns指示項目が指定されていると､与えられた列に関する値のみが返される｡ Returns the values of a row or a range of rows. If the -columns option is specified, only the values for the given columns are returned.

tag add|delete|remove|cget|configure|lower|raise|ranges|names|bind ?args?
この命令は､張札の適用と制御を許容する｡ これは 張札が元の文書部品内で使用される方法に非常に似ている｡ 小部屋は一つ或いはそれ以上の､名前によって識別される 張札を持つことができる｡ それぞれの張札は､構成設定でき､譬えば､特定の背景色は､ この特定の張札を有する全ての小部屋に､順に､その色が適用される｡ This command allows to apply and control tags. This is very similar to the way tags are used in the original text widget. Cells can have one or more tags, which are identified by a name. Each tag can be configured, e.g. with a certain background color, which in turn would apply this color to all cells that have this particular tag.
tag add tag-name cell-spec1 ?cell-spec2? は､ 張札-名前によって指定される張札を､ cell-spec1 (及び cell-spec2)によって指定される小部屋(範囲)に 加える｡ tag remove tag-name cell-spec1 ?cell-spec2? は､加えられた特定の張札を､ 小部屋や小部屋範囲から取去る｡ tag names cell-specは､単一の小部屋に取付けられた全ての張札を返す｡ もし､小部屋の範囲が指定されると､最初の小部屋が採られる｡ tag ranges tag-name は､指定された張札を現在有している全ての小部屋を返す｡ 全ての他の張札命令は､ 文書 部品 の為の張札命令の様に正確に働く｡ tag add tag-name cell-spec1 ?cell-spec2? adds the tag specified by tag-name to the cell (range) specified by cell-spec1 (and cell-spec2). tag remove tag-name cell-spec1 ?cell-spec2? removes a previously added tag from a cell or a cell range. tag names cell-spec returns all tags attached to a single cell. If a cell range is specified, the first cell is taken. tag ranges tag-name returns all cells that have the specified tag currently attached. All other tag commands work exactly like the tag commands for the text widget.

selection clear|get|set ?row-range ...?
選択を制御する｡ clearは選択を解消する､ set row-range ?...?は､指定された列､又は列の範囲について選択を設定する､ get は現在選択されている全ての行のリストを返す｡ Controls the selection. clear clears the selection, set row-range ?...? sets the selection for the specified row or range of rows, get returns a list of all rows that are currently selected.

image create|delete|configure|cget|names ?cell-spec? ?image-options?
映像を特定の小部屋又は小部屋の範囲に張付けることを許容する｡ 映像指示項目は､ text 部品のimage命令によって受容れられる様でなければならない｡ Allows to attach an image to a particular cell or cell range. The image options must be those as accepted by the image command of the text widget.

bind bind-arguments
束縛引数を直接にリスト制御に適用する｡ 列先頭は束縛を受容れない｡ Applies bind arguments directly to the listcontrol. The column headers do not accept bindings.

see row
特定の小部屋を可視にする､もし､視界の外にあると｡ Makes a particular cell visible, if it out of sight.

size
行の総数を返す｡ Returns the total number of rows.

## Pane

### 名称 Name

pane - 窓枠部品 A pane widget

### Description

pane 高次部品は､二人使用者の容れ物-と定義された部品である｡ これら二人の間の､部品は薄い枠であり､ それは､引張ることができ､又､それで､二人の使用者部品を寸法変更する｡ The pane metawidget is a container for two user-defined widgets. Between these two widgets is a thin frame that can be dragged and hereby resizes the two user widgets.

### 初期設定 Default

初期設定の部品は引張り可能な窓枠である｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is the draggable frame. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-orientation vertical|horizontal
窓枠が二人の部品に水平に又は垂直に分離されるかを定める｡ Determines if the pane shall separate the two user widgets horizontally or vertically.

-width pixels
引張り可能な枠の巾を設定する｡ Sets the width of the draggable frame.

-resize both|first|second
窓枠部品そのものが寸法変更される時に 如何に二人の使用者部品が寸法変更されるか､を制御する｡ bothは部品を比例的に寸法変更する､ firstは左(頂)部品のみ､secondは右(底)部品のみ､ を寸法変更する｡ Controls how the two user widgets are being resized when the pane widget itself is resized. both resizes the widgets proportionally, first resizes only the left (top) widget, and second resizes only the right (top) widget.

-update boolean
二人の使用者部品が､引張られる間に再描写されるかを定める｡ もし､否であれば､それらは鼠釦が離された后のみに再描写される｡ Defines if the two user widgets shall be redrawn during dragging. If not, they will be redrawn only after the mouse button is released.

### 命令 Commands

set position ?both|first|second?
窓枠を新しい位置に設定する｡もし､both(初期設定)が指定されると､ positionは､百分率値として採られる(譬えば､set 50は窓枠の真ん中)｡ そうでない場合､画素値とする(譬えば､ set 50 firstは左(頂)部品50画素巾(高さ)になす)｡ Sets the pane to a new position. If both (the default) is specified, position is taken as a percentage value (e.g. set 50 would center the pane). Otherwise as a pixel value (e.g. set 50 first makes the left (top) widget 50 pixels wide (tall)).

get ?both|first|second?
setの反対側｡百分率か画素単位で､窓枠の位置を返す｡ The counterpart of set. Returns the position of the pane, either in percent or in pixels.

place|pack|grid first|second window-name ?args?
容器部品の最初(左､頂)か､二番目(右､底)部分の､どちらかの窓を､ 詰込むか配置する｡ Places, packgs or grids a window either into the first (left, top) or second (right, bottom) part of the container widget.

## Progressbar

### Name

progressbar - 単純な"アナログ"の進捗帯 A simple "analog" progress bar

### 説明 Description

progressbar高次部品は何かの処理の進捗を可視化する 事を許容する､ 譬えば､ファイルの積込み､或いは､データの進捗｡ The progressbar metawidget allows to visualize the progress of some process, e.g. the loading of a file or processing of data.

### 初期設定 Default

初期設定の部品は進捗帯の背景領域､と､ 枠型 である｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is the area behind the progress bar and is of type frame. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-background color
進捗帯の色を設定する｡ Sets the color of the progress bar.

-foreground color
文字列表示の色を設定する｡ Sets the color of the text display.

-font font-spec
文書表示の為の字母を設定する｡ Sets the font of the text display.

-format format-string
文字列表示に使われる書式を定める｡ Defines the format to be used for the text display.

### 命令 Commands

set value ?base-value?
進捗帯を設定する｡ もし､基準値が与えらえないと valueは百分率値 (0-100)として 解釈される｡ 基本値はvalueとして使われる最大値を定める｡ value==base-value に関して､進捗帯は､完全に表示される｡ Sets the progress bar. If no base value is given, value is interpreted as a percent value (0-100). The base value determines the maximum value to be used for value. For value==base-value, the progress bar is fully displayed.

## Scrollbox

### 名称 Name

scrollbox - 自動巻上帯付きの標準的リスト箱 A standard listbox with automatic scrollbars

### 説明 Description

scrollboxは､ 必要な時に垂直と水平の巻上帯が付着される事を除いて､ 通常のリスト箱と､同じである｡ それは､ リスト箱内の 全ての行が完全に表示され得て､且つ､可視領域の外側には､ 情報が何もない時には､それが表示されない｡ 更に､少しの"豪華な命令"が搭載されている｡ それらは､ その索引よりも､ 名前(即ち､表示される文書)によって､リスト箱内の内容への対処を許容する｡ The scrollbox metawidget is identical to a regular listbox, except it has a vertical and a horizonal scrollbar attached that pop up only when they are needed. That is, they are not displayed, when all lines of the listbox can be displayed in full, and no information is outside the viewable area. In addition, a few "luxury commands" have been implemented. They allow to address entries in the listbox by their name (i.e. the text that is displayed) rather than their index.

### 初期設定 Default

初期設定の部品はリスト箱である｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is the listbox. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-scrollbar auto|on|off
必要な場合､自動的に 巻上げ棒が表示されるべきか､ 又は､ もし､それぞれ常に断であるべきか､ を制御する｡ Controls if the scrollbars should be displayed automatically when needed, or if they should always be on respectively off.

### 命令 Commands

find entry ?entry ...?
リスト箱内に見つけられる入力の索引(番号)を 含むリストが 返される｡ A list is returned containing the indexes (position) of those entries that could be found in the listbox.

selection setbyval|get|standard-options ?args?
二つの機能により標準リスト箱選択命令を拡張する: setbyval は 引数内の全ての入力(索引ではない)の為に､選択を設定する､ getは 現在､選択された入力(索引ではない)全てのリストを返す｡ Extents the standard listbox selection command by two functions: setbyval sets the selection for all entries (not indexes) in args. get returns a list of all currently selected entries (not indexes).

set entry ?entry ...?
既存の全ての入力を削除し､新しい入力を挿入する｡ Deletes all existing entries and inserts new ones.

remove entry ?entry ...?
リストから特定の入力を取除く｡ Removes particular entries from the list.

sort standard-lsort-args
入力を並び揃える｡引数は､ lsort命令によって 受容れられるものでなければならない｡ Sorts the entries. The arguments must be those accepted by the lsort command.

## Spinentry

### 名称 Name

spinentry - 上げ下げ矢印付きの入力欄 An entry field with up and down arrows

### 説明 Description

spinentry高次部品は､ 標準入力部品に比較して､ 右側に 二つの矢印釦がある事を除いて､ 殆ど同一である｡ この釦を押すか､上げ下げ遊走子鍵の使用で､ 入力部品内部の数値を増加又は､減少する｡ The spinentry metawidget is almost identical to a standard entry widget, except it has two arrow buttons on the right side. Pressing these buttons or using the up and down cursor keys increments or decrements a numeric value inside the entry widget.

### Default

初期設定部品は入力部品｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is the entry widget. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-step value
増加や減少の為に使われる跳び巾を設定する｡ Sets the step width to be used for increments and decrements.

-speed milliseconds
鼠が､矢印釦上に掴み落された時使われる巻上速度を設定する｡ Sets the scrolling speed to be used when the mouse is held down on the arrow buttons.

-minimum|-maximum value
入力部品の為の最小と最大の値を定義する｡ Defines a minimum and maximum value for the entry widget.

-onerror cmd
入力部品内の値がそれぞれ増加､減少されない場合に呼出される記述譜を定義する｡ もし cmdが空文字列の場合､不都合は捕まらなくなる｡ 　 Defines a script to be called when the value in the entry widget cannot be incremented respectively decremented. If cmd is an empty string, then errors will not be caught.

-value value
入力部品内部の値を設定する｡又､もし値が数値型の値であるかを確認する｡ 数値型でない場合､不都合が返される｡ 　 Sets the value inside the entry widget. Also checks if the value is of numeric type. If not, an error is returned.

### 命令 Commands

なし (none)

## Statusbar

### 名称 Name

statusbar - 窓の釦の融通の利く状態帯 A flexible status bar at the bottom of a window

### 説明 Description

statusbar高次部品は窓の釦を突き､すると､ 幾つかの文書(通常､何か有益な状態情報)を表示する｡ 更に､"数値"進捗帯と､ アイコンと文書を含み得る､ 任意の個数の追加欄､ とを表示する｡ The statusbar metawidget sticks to the bottom of a window and displays some text (normally some helpful status information). In addition, it may show a "digital" progress bar and an arbitrary number of additional fields, which may contain an icon and text.

### 初期設定 Default

初期設定部品は､ 状態文書を表示する 名札である｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is the label that displays the status text. The metawidget accepts all commands and configuration options of this widget type.

### Options

-ticks number
進捗帯を状態帯の右側に､ 指定された"lights"(即ち､灰色矩形)の数によって､ 表示する｡ 特定の進捗値を表示する為に､ 指示項目-progressを使う｡ Displays a progress bar at the right side of the status bar, with the specified number of "lights" (i.e., gray rectangles). To show a certain progress value, use the option -progress.

-progress value
特定の進捗を進捗帯内に可視化する｡ 値は､0 と 1 の間でなければならない｡ 1は進捗帯内で､全て､ 0.5 は左半分のみ､ 0 は無しに､ "点灯"に に切替える｡ Visualizes a certain progress in the progress bar. The value must be between 0 and 1. 1 would switch on all "lights" in the progress bar, 0.5 only the left half of them, 0 none.

-state normal|withdrawn
状態帯を､明示又は隠蔽する｡ 状態帯は､常に､親の窓内に描かれる｡ Shows or hides the status bar. The status bar is always drawn inside its parent window.

-text string
状態帯の中に文書を設定する｡ 文書は､push命令により負荷積みされ得る､又､ pop命令により､再定義することなく､取戻される｡ Sets a text in the status bar. The text can be overloaded with the push command and be recovered without redefinition with the pop command.

### Commands

push string
新しい文書を伴う､現在表示されている文書が過負荷である｡ 高次部品は､全ての過負荷文書を棚に維持している､ そこで､逆の順に復元する｡ Overloads the currently displayed text with a new text. The metawidget maintains a stack of all overloaded texts, so they can be recovered in the opposite order.

pop
最後の push命令により定義された文書を取外し､ それを"裏側に underneath"の文書を表示する｡ Removes the text defined with the last push command and displays the text that is "underneath" it.

add field-name ?args?
アイコンと文書を表示できる欄を搭載する｡ その欄の名前は状態帯にに関して唯一でなければならない｡ どの様な追加の引数もitemconfに渡される｡ Installs a new field, which can display an icon and text. The field name must be unique for the status bar. Any additional arguments are passed to itemconf.

delete field-name ?field-name ...?
状態帯から欄を取外す｡ Removes fields from the status bar.

itemconf field-name option value ?option value ...?
欄を構成設定する｡それぞれの欄は 枠と､ 映像と文書名札 で構成される｡ 結局､全ての指示項目は それらの三つの部品が受容れる様なものを受容れる｡ 高次部品はそれらを適切な内部の部品に適用する｡ Configures a field. Each field consists of a frame, an image and a text label. Consequently, all options are accepted that these three widget types would accept. The metawidget will apply them to the appropriate inner widget(s).

itemcget field-name option
特定の指示項目の欄の値を返す｡ Returns the value of a particular option of a field.

## Tabcontrol

### Name

tabcontrol - 複数行の耳部品 A multi-row tab widget

### 説明 Description

tabcontrol高次部品は､ 頂に耳の行を保持する､ 容器部品である｡ どの耳が活性化されたかに従って､部品は異なる内容を見せる｡ 通常､これは制限対話の為に使われる｡(訳註：ttk::notebook) The tabcontrol metawidget is a container widget that contains a row of tabs at the top. Depending on what tab is activated, the widget will show a different content. Usually, this is used for modal dialogs.

### 初期設定 Default

初期設定部品は容器の外部枠である｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is the outer frame of the container. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-width auto|pixels|percent%
耳の行の巾を制御する｡autoに関して､耳は耳名札を表示する為に要求される個別の寸法を有することになる｡ もし､百分率値が指定されると､耳は部品の巾全体のその百分率を覆う｡ もし､平らな画素値が指定されると､耳はその画素の数量を覆う為に描かれる｡ Controls the width of the tab row. For auto the tabs will have the individual size required to display the tab label. If a percentage value is specified, the tabs will cover that percent of the entire widget's width. If a plain pixel value is specified, the tabs will be drawn to cover exactly that amount of pixels.

### 命令 Commands

insert tab-name row ?args?
新しい耳を生成する｡耳は高次部品内で唯一の名前でなければならない耳-名により識別される｡ 耳は指定された行に､左から右に詰込まれる｡ どの様な追加の引数もtabconfigureに渡される｡ Creates a new tab. Tabs are identified by a tab-name which must be unique for the metawidget. Tabs are filled into the specified row from the left to the right. Any additional arguments are passed to tabconfigure.

delete tab-name
指定された耳を削除する｡ Deletes the specified tab.

tabconfigure tab-name option value ?option value ...?
耳を構成設定する｡それぞれの耳は実際は名札である､従って､全ての名札指示項目が受容れられる｡ 更に､二つの特別の指示項目がある: -window は耳が活性の時に表示される使用者部品を指定する｡ -commandは耳が活性化される毎に評価されるべき記述譜を指定する｡ Configures a tab. Each tab is actually a label, therefore all label options are accepted. In addition there are two special options: -window specifies the user widget to be displayed when the tab is active. -command specifies a script to be evaluated each time the tab is activated.

tabcget tab-name option
耳の為の指示項目の値を返す｡ Returns an option value for a tab.

invoke
耳を活性化し､その関連する使用者部品を見せる｡ Activates a tab and shows its associated user widget.

get ?active|row?
もし､引数が何もないと､全ての耳の名前を返す｡ もし､active が指定されると､活性の耳を返す｡ もし､有効な行数が指定されると､その行内の耳を返す｡ If no arguments is specified, returns all tab names. If active is specified, returns the active tab. If a valid row number is specified, returns the tabs in this row.

bind tab-name bind-arguments
束縛引数を耳に直接適用する｡ Applies bind arguments directly to a tab.

## Textframe

### 名称 Name

textframe - 表題文書を伴う枠 A frame with a title text

### 説明 Description

textframe高次部品は表題文書を伴う通常の枠部品である｡ The textframe metawidget is a regular frame widget with a title text

### 初期設定 Default

初期設定部品は枠そのものである｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is the frame itself. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-anchor n|s|w|e|c
表題文書の錨位置をを枠に相対的に指定する｡ Specifies the anchor position of the title text relative to the frame.

-offset value
表題文書の為の字下がり値を設定する｡ 三つの異なる書式がある: 譬えば､20%は､名札を､枠の巾の左から20%離す｡ 20 は左の縁から20画素名札を設定する(-anchor w を伴うのが良い)｡ end-20 はそれを枠の右縁から設定する(-anchor e を伴うのが良い)｡ Sets an offset value for the title text. There are three different formats: E.g. 20% sets the label 20% of the frame's width off from the left. 20 sets the label 20 pixel from the left border (good with -anchor w). end-20 sets it from the frame's right border (good with -anchor e).

-font font-spec
表題文書の為の字母を設定する｡ Sets the font for the title text.

-text string
表題文書を設定する｡ Sets the title text.

### 命令 Commands

pack|place|grid window ?args?
文書枠部品の内側に使用者の部品をpacksや, placeや､ grid する｡ Packs, places or grids user widgets inside the textframe widget.

## Toolbar

### Name

toolbar - 道具釦の為の容器部品 A container widget for tool buttons

### 説明 Description

道具帯は､画像的応用譜内では人気のある要素である｡ 道具帯は､応用譜のメニューから 入口を表す数多くのアイコンを含む｡ 従って､それらは特定の応用譜函数の短縮記号に似ている｡ アイコンは屡々通常の釦の如く振舞う ､しかしながら､確認釦やラジオボタンの如く動作できる｡ toolbar高次部品は､複合部品に似ている｡ 釦と､確認釦と､ラジオボタンは定義され得る､ 又､釦の群は分離線により分離できる､ 又､道具帯の全体はその親の窓の四つの方向から引き摺り入れることができる｡ Toolbars are popular elements in graphical applications. Toolbars contain a number of icons that represent entries from the application's menu. Hence, they are like shortcuts to certain application functions. The icons often behave like regular buttons, but can also act like checkbuttons and radiobuttons. The toolbar metawidget resembles such a complex widget. Buttons, checkbuttons and radiobuttons can be defined, groups of buttons can be separated by a separator line, and the entire toolbar can be dragged to the four sides of its parent window.

### 初期設定　 Default

初期設定部品は､外側枠であり､それが道具帯を含む｡ 高次部品は全ての命令と､この部品型の構成設定指示項目を､受容れる｡ The default widget is the outer frame that contains the tool buttons. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-side top|bottom|left|right
現在の部品の四つの側面の内の一つに道具帯を張付ける｡ Attaches the toolbar to one of the four sides of its parent widget.

-state normal|fixed|withdrawn
道具帯が隠されるか可視かを制御する｡ -state fixed に関して､道具帯は引き摺りできない｡ Controls whether the toolbar shall be hidden or visible. For -state fixed the toolbar cannot be dragged.

### 命令 Commands

add button|checkbutton|radiobutton|separator name ?args?
道具帯に新しい品目を追加する｡ 品目は､名前により認識され､ 道具箱に関して唯一でなければならない｡ 追加の引数は､指示項目-値対であることが期待され､ itemconfに渡される｡ ラジオ釦型に関して､一つの特別な指示項目-group group-nameがあり､ それは､ 品目が属すべきラジオ釦を識別する｡ Adds a new item to the toolbar. Items are identifed by a name that must be unique for the toolbar. Additional arguments are expected to be option-value pairs and are passed on to itemconf. For the radiobutton type, there is one special option -group group-name, which identifies to which radiobutton group the item shall belong.

delete name ?name ...?
品目を道具帯から削除する｡ Deletes items from the toolbar.

itemconf name option value ?option value ...?
品目を構成設定する｡釦部品が受容れる全ての指示項目を受容れる｡ 特に､ アイコンを設定する為の-image 行動を定義する為の -command はここでは､重要である｡ Configures an item. Accepts all options that a button widget would accept. In particular, -image to set an icon and -command to define an action are important here.

itemcget name option
指定された品目の指示項目値を返す｡ Returns an option value of the specified item.

invoke name ?new-state?
道具釦を起動する｡　恰も押された様に｡ もし､ 確認釦の型の品目の場合､ 論理値new-stateは､ 確認釦の新しい状態を定め得る｡ この引数は釦とラジオボタン品目型には適用されない｡ Invokes a tool button. Same as if it was pressed. If the item is of type checkbutton, then new-state, a boolean, may define the new state of the checkbutton. This argument does not apply to button and radiobutton item types.

set name ?new-state?
関連する要素の命令が呼出されたのでなければ､起動と同じ｡ これは､譬えば､ 道具釦を表している機能が､何処か(譬えば､メニューから)から呼出され､ そして､道具釦が刷新される必要がある時のみ 使用される｡ Same as invoke except that the item's associated command is not called. This is used e.g. when the function that the tool button represents has been called from somewhere else (e.g. from the menu) and now the tool button needs to be updated only.

get name
道具釦の状態を論理値として返す｡通常の釦では､常に0を返す｡ Returns the state of a tool button as boolean. For regular buttons, always returns 0.

names ?pattern?
全ての道具釦の名前のリストを返す｡もし､塊-様式の文様が与えらえると､ その文様に合致する 名前のみが返される｡ Returns a list with the names of all tool buttons. If a glob-style pattern is given, only those names are returned that match the pattern.

## Tooltip

### 名称 Name

道具片 tooltip - 部品の上を移動する時情報が跳出す Pop-up information when moving over a widget

### 説明 Description

tooltip高次部品は 今風の使用者対話機能の標準である特性を提供する｡ 何時であれ､使用者が､ アイコン等の､要素を上に架ける時､ すぐ後に､屡々､黄色っぽい小さな文書窓の様な要素を､跳び出し､ それにより､ その釦の意味を説明する｡ その文書は､鼠遊走子が釦の領域を去ると､ 消える｡ The tooltip metawidget provides a feature that is standard of nowadays user interfaces: Whenever the user hovers over an element, such as an icon, a often yellowish little text window pops up after a second or so that explains the meaning of that button. The text disappers when the mouse leaves the area of the button.

### 初期設定 Default

初期設定の部品の型はlabelである｡ それは道具片窓そのものである｡ 高次部品は､全ての命令とこの部品型の構成設定指示項目を受容れる｡ The default widget is of type label. It is the tooltip window itself. The metawidget accepts all commands and configuration options of this widget type.

### Options

-delay milliseconds
使用者が部品領域に入力した后､ 道具片が跳出す事になる前に時間切れする為の時間｡ Time to expire before the tooltip shall pop up after the user entered a widget's area.

### Commands

add widget-name string
特定の 使用者-定義部品の為の道具片を活性化し､そして､表示すべき文書を定義する｡ その文書は､ 以前にforgetを呼出させることなく､ この命令を再度呼出して変更することができる｡ Activates the tooltip feature for a particular user-defined widget and defines the text to be displayed. The text can be changed by calling this command again without having to call forget before.

forget widget-name
特定部品の為の 道具片特性を削除する｡ Removes the tooltip feature for a particular widget.

## Treecontrol

### Name

treecontrol - 良好な樹枝部品 A fairly nice tree widget

### 説明 Description

treecontrol高次部品は､任意の個数の節を伴う探検者様式の樹枝の生成を許容する｡ 節は+/- アイコン(それを展開及び崩壊する)と､使用者-定義アイコンと､名札 を含む｡ 選択は､ シフト鍵と制御鍵の使用も含め､ 期待通りに振舞う｡ 樹枝を通る操縦は鼠遊走子か文字鍵盤経由でなされる｡+/-アイコン上での二重-軽叩は節を展開又は崩壊する､ 又､右と左に遊走子が行う｡ もし､更に､シフト鍵が押されると､全ての仔節がそれぞれ展開され､同様に崩壊される The treecontrol metawidget allows to built an Explorer-style tree with an arbitrary number of nodes. A node consists of a +/- icon (to expand and collapse them), a user-defined icon and a label. Selection behaves as expected, including the use of the Shift and Control keys. Navigation through the tree is done via mouse or keyboard. A double-click on the +/- icon expands or collapses a node, and so do the cursor keys for left and right. If, in addition, the Shift key is pressed then all subnodes are expanded respectively collapsed as well.
呼戻しは節束縛経由で定義される｡ 特定の便利な特性は 樹枝は利用可能以前は､完全には定義されなくてもよい｡ その代り､頂水準節のみ定義することで充分であり､次に 何時であれ､頂水準の節の一つが展開される時､樹枝部品に節の子供を問わせる｡ これは､特別の呼戻しに経由でなされる｡ Callbacks are defined via node bindings. A particular useful feature is that the tree does not have to be completely defined before being able to use it. Instead, it is sufficient to define the toplevel nodes only, and then let the tree widget ask for a node's children whenever one of the toplevel nodes is expanded. This is done via a special callback.
全体の樹枝部品は一つの文書部品から生成される｡その開発者に我が最高の尊敬! The entire tree widget is built from a single text widget. My highest respect for its developer!

### 初期設定 Default

初期設定部品は､樹枝部品そのものであり､且つ､ text型である｡ 高次部品は､全ての命令と部品型の構成設定指示項目を受容れる｡ The default widget is the tree widget itself and is of type text. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-text string
全ての樹枝は一つの根本を有す それは､常に部品の頂にある｡この指示項目は 根本節の名札を設定する｡ Every tree has one root node that is always at the top of the widget. This option sets the label of the root node.

-image image-name
根本節の為に使われる映像を設定する｡ Sets the image to be used for the root node.

-fullexpand boolean
使用者にシフト鍵が押された時に､ 節の全ての仔節が自動的に展開される事を許容するかを制御する｡ この性質は､望まれないかもしれない､譬えば､もし､樹枝がファイル系を表し､ 且つ､ 使用者が高水準ディレクトリ､譬えば / や c:\ の時｡ 展開は仮想的に永久に採られる｡ Controls whether automatic expanding of all subnodes of a node shall be allowed, when the Shift key was pressed by the user. This feature may be not desired e.g. if the tree represents a file system and the user is in a high level directory, e.g. / or c:\. Expansion might virtually take forever.

-selectmode single|multiple
同時に､ 一つだけの､又は､一つ以上の節が選択できるかどうかを制御する｡ Controls whether only one or more than one node can be selected at a time.

-onexpand command
ここで指定されている命令は､ 何時であれ､節が拡張され､且つ､その節の子供が未知である､或いは､節が"final"として定義されてない場合に､ 評価される(下のnodeconfigure参照)｡ 拡張されるべき節が命令に引数として追加され､ 且つ､命令が､ insert命令を手段として 全ての子供を樹枝に加える事が期待されると､ 呼戻しはなされない｡ The command specified herein is evaluated whenever a node is being expanded and the children of that node are not known yet, or the node is not defined as "final" (see nodeconfigure below). The to-be-expanded node is appended to the command as an argument, and the command is expected to add all children to the tree by means of the insert command. If command is an empty string, no callback will be made.

-onselect command
もし､命令が空文字列でない場合､選択が変更される度に評価される｡ If the command is not an empty string, it is evaluated each time the selection changes.

### 命令 Commands

insert node ?args?
樹枝に新しい節を挿入する｡節は､樹枝全体で唯一の名前で参照されねばならない｡ 追加の引数は､指示項目-値対であると期待され､nodeconfigure命令に渡される(下を参照)｡ 　 Inserts a new node to the tree. Nodes are referenced by a name that must be unique over the entire tree. Additional arguments are expected to be option-value pairs and are passed on to the nodeconfigure commmand (see below).

delete ?node?
特定の節とその全ての子供を削除する､もし､名前が指定されないと樹枝全体を削除する｡ Deletes a particular node and all its children, or the entire tree, if no name is specified.

nodeconfigure node option value ?option value ...?
節を構成設定する｡許容される指示項目は: Configures a node. Allowed options are:
-parent node: 新しい親節を設定する｡節はその親節の子供として描かれる｡樹枝の根本節は空文字により表示される｡ Sets a new parent node. The node will be drawn as a child of that parent node. The tree's root node is represented by an empty string.
-text string: 節の名札を設定する｡ Sets the nodes label.
-image image-name: 節の為のアイコンを設定する｡もし映像名が空文字列の場合､アイコンを取外す｡ Sets an icon for the node. If the image name is an empty string, removes the icon.
-final boolean: 与えられた節が完全な樹枝部品であるかを告げる､ 即ち､全てのその子供が定義済である｡ 樹枝部品は､ その節が拡張されていると､ -onexpand命令では全く呼出されない､ Tells the tree wigdet that the given node is complete, i.e. all of its children are defined. The tree widget will not call the -onexpand command any more when this node gets expanded.
-user string: 任意の使用者データ｡節に伴って保存されるが使用されない｡ Arbitrary user data. Just stored with the node but never used.

nodecget node option
節-指示項目の値を返す｡ nodeconfigureの元で指示項目を記述するに加え､次の指示項目が受容れられる: Returns the value of a node option. Besides from the options described under nodeconfigure, the following options are accepted:
-children 全ての仔節のリストを返す｡ returns a list of all child nodes.
-indention 節の現在の段階水準を返す｡ returns the current indention level of the node.
-expanded 現在､節が拡張されているか否かの論理値を返す｡ returns a boolean indicating if the node is currently expanded.
-tags 現在節に関連する全ての張札のリストを返す｡ returns a list of all tags currently associated with the node (see below).
-visible 節が可視かを示す論理値を返す､即ち､全てのその親は展開されている｡(樹枝の表示領域はどこか別なので､節は画面上に猶も無いかもしれない｡) returns a boolean indicating if the node is visible, i.e. all of its parents are expanded. (The node can still be not on the screen because the tree's viewport is somewhere else.)

nodebind node ?bind-arguments?
特定の節の為に束縛を生成する｡これは､異なる節に異なる動作を定義する｡ 譬えば､ファイル系樹脂内で､ ディレクトリーの二重-軽叩は､通常それを展開する､ ファイルの二重-軽叩は､それを表示する｡ Creates bindings for a particular node. This allows to define different actions for different node types. E.g. in a filesystem tree, double-clicking a directory normally expands it, while double-clicking a file displays it.

expand node ?recursive-flag?
節を展開し､もし､追加旗印が真値なら､その仔節も全部展開する｡ Expands a node and, if the optional flag is true, all of its subnodes.

collapse node ?recursive-flag?
節を崩壊する､そして､もし追加は旗印が真値の場合､その全ての仔節を崩壊する｡ Collapses a node and, if the optional flag is true, all of its subnodes.

move node ?-byname? ?-after? position
節をその兄弟の内側の指定された位置に移動する｡もし-bynameが指定されると､ positionは兄弟の節の名称でなければならない( 若しくは､何か他の節､ その場合､節は node によって指定され､親元に戻される｡） 節は､ -afterが指定されてない限り､ 兄弟の節の前に設置される｡ Moves a node to a specified position within its siblings. If -byname is specified, position must be the name of a sibling node (or any other node, in which case the node specified by node gets reparented). The node will be placed before the sibling node, unless -after is specified.

tag add|delete|remove|cget|configure|lower|raise|names|nodes|bind ?args?
この命令は､樹枝内の節の為の張札への適用と制御を許容する｡ これは張札が原資のtext部品内に使われる張札への方法と似ている｡ 節は､一つ或いはそれ以上の張札を有し得る､ それらは､名前で識別される｡ それぞれの張札は､構成設定できる､ 譬えば､特定の背景色 は､この特定の張札を有する全ての節に 順番に 適用できる｡ This command allows to apply and control tags for nodes in the tree. This is very similar to the way tags are used in the original text widget. Nodes can have one or more tags, which are identified by a name. Each tag can be configured, e.g. with a certain background color, which in turn would apply this color to all nodes that have this particular tag.
tag add tag-name node ?node ...? tag-nameにより指定される張札を一つ或いはそれ以上の節に追加する｡ adds the tag specified by tag-name to one or more nodes. tag remove tag-name node ?node ...? 一つ或いはそれ以上の節から以前の追加張札を取外す｡ removes a previously added tag from one or more nodes. tag names node 節に張った全ての張札を返す｡ returns all tags attached to a node. tag nodes tag-name 現在指定された張札を有する全ての節を返す｡他の全ての張札命令は､text部品への張札命令の如く正確に働く｡ returns all nodes that currently have the specified tag. All other tag commands work exactly like the tag commands for the text widget.

selection clear|get|set ?node-names-list?
選択を制御する｡ clearは選択を解消する､ set node-names-listは､指定された節の為の選択を設定する､ getは現在選択されている全ての節のリストを返す｡ Controls the selection. clear clears the selection, set node-names-list sets the selections for the specified nodes, get returns a list of all nodes that are currently selected.

get from-row ?to-row?
二つの指定された行の間の節のリストを返す｡ 返されるリストは､ どの節が拡張されたか､そして､どれが崩壊したかに依存する､ 即ち､ その親が崩壊した為に見えない節は､リストの部分ではない｡ Returns a list of nodes that are between the two specified rows. The returned list depends on which nodes are expanded and which ones are collapsed, i.e., nodes that are not visible because their parent is collapsed, are not part of the list.

see node
節を画面上に可視にする｡ もし､節のどれかの親が崩壊していると､それは最初に展開されて､節が部品内に描かれる｡ 従って､可視領域が設定されると､節は画面上に現れる｡ Makes a node visible on the screen. If any of the node's parents are collapsed, then they are expanded first, so that the node is drawn into the widget. Then the viewport is set, so that the node appears on the screen.

bind bind-arguments
樹枝状部品に直接束縛を適用する｡ Applies bindings directly to the tree widget.

nodes
可視であれ不可視であれ､全ての節､を返す｡ Returns an unordered list of all nodes, whether visible or not.

tree node
再帰的リストとして指定された節で出発する仔樹枝の構造を返す｡ それぞれのリスト要素はそれ自身二つの要素を伴うリストである: 節の唯一の名前と子供の節｡ Returns the structure of the subtree starting at the specified node as a recursive list. Each list element is itself a list with two elements: the node's unique name and its child nodes.

## Window

### 名称 Name

window - 頂上水準部品とwm命令の周りの包装 A wrapper around the toplevel widget and the wm command

### 説明 Description

高次部品windowの目的は､窓部品とwm命令の一体化である｡ それは､高次部品とは距離があるが､頂上水準部品の取扱いを容易化する｡ The window metawidget's purpose is to unify the window widget and the wm command. It is in so far not a true metawidget, but it makes the handling of toplevel widgets easier.

### 初期設定 Default

初期設定の部品は頂上水準部品である｡ 高次部品は､この部品型の 全ての命令と構成設定指示項目を受容れる｡ The default widget is a toplevel widget. The metawidget accepts all commands and configuration options of this widget type.

### 指示項目 Options

-geometry geometry-string
窓の位置と寸法を設定する｡ 幾何学的文字列は"wm geometry"のもとで記述されたと 同じ書式でなければならない｡ Sets position and size of the window. The geometry string must have the same format as described under "wm geometry".

-minsize|-maxsize list
窓の､最小と最大の寸法を設定する｡ リストは 設定される巾と高さを含まねばならない｡ Sets the minimum and maximum size of the window. The list must contain the width and height to be set.

-resizable list
もし､窓が x 及び/又は y 方向に寸法変更されるなら､指定する｡ リストは x 方向と y 方向とに関する二つの論理値を含まねばならない｡ Specifies if the window can be resized in x and/or y direction. The list must contain two booleans for the x and y direction.

-override boolean
窓が､窓管理譜によって無視されるか否かを制御する｡ Controls if the window is ignored by the window manager.

-ondelete command
窓管理譜が窓を閉じることを望むか否かを定める｡ 本命令は､最終的に､窓自身を破壊せねばならない｡ Specifies a command to run whenever the window manager wants to close the window. The command must eventually destroy the window itself.

-title string
窓の表題を設定する｡ Sets the window title.

-state normal|iconic|withdrawn
窓の状態を設定する: 通常か､アイコン化されたか､隠されたか｡ Sets the window's state: Normal, iconified, or hidden.

### 命令 Commands

resize width height
窓の寸法を設定する｡ Sets the size of the window.

move x y
窓を新しい位置に移動する｡ Moves the window to a new position.

protocol wm-protocol-args
全ての引数は､直接wm protocolに渡される｡ All arguments are directly passed to wm protocol.

## AUTHOR

Michael Kraus
mailto:michael@kraus5.de
http://mkextensions.sourceforge.net