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

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

  NAME
    listbox — 品目リストの部品 '列挙箱' を生成し操作する Create and manipulate 'listbox' item list widgets
  構文 SYNOPSIS
  STANDARD OPTIONS
    -background or -bg, background, Background
    -borderwidth or -bd, borderWidth, BorderWidth
    -cursor, cursor, Cursor
    -disabledforeground, disabledForeground, DisabledForeground
    -exportselection, exportSelection, ExportSelection
    -font, font, Font
    -foreground or -fg, foreground, Foreground
    -highlightbackground, highlightBackground, HighlightBackground
    -highlightcolor, highlightColor, HighlightColor
    -highlightthickness, highlightThickness, HighlightThickness
    -justify, justify, Justify
    -relief, relief, Relief
    -selectbackground, selectBackground, Foreground
    -selectborderwidth, selectBorderWidth, BorderWidth
    -selectforeground, selectForeground, Background
    -setgrid, setGrid, SetGrid
    -takefocus, takeFocus, TakeFocus
    -xscrollcommand, xScrollCommand, ScrollCommand
    -yscrollcommand, yScrollCommand, ScrollCommand
  部品固有指示項目 WIDGET-SPECIFIC OPTIONS
    -activestyle, activeStyle, ActiveStyle
    -height, height, Height
    -listvariable, listVariable, Variable
    -selectmode, selectMode, SelectMode
    -state, state, State
    -width, width, Width
  説明 DESCRIPTION
  参照番号 INDICES
    number
    active
    anchor
    end
    @x,y
  部品命令 WIDGET COMMAND
    pathName activate index
    pathName bbox index
    pathName cget option
    pathName configure ?option? ?value option value ...?
    pathName curselection
    pathName delete first ?last?
    pathName get first ?last?
    pathName index index
    pathName insert index ?element element ...?
    pathName itemcget index option
    pathName itemconfigure index ?option? ?value? ?option value ...?
      -background color
      -foreground color
      -selectbackground color
      -selectforeground color
    pathName nearest y
    pathName scan option args
      pathName scan mark x y
      pathName scan dragto x y.
    pathName see index
    pathName selection option arg
      pathName selection anchor index
      pathName selection clear first ?last?
      pathName selection includes index
      pathName selection set first ?last?
    pathName size
    pathName xview ?args
      pathName xview
      pathName xview index
      pathName xview moveto fraction
      pathName xview scroll number what
    pathName yview ?args?
      pathName yview
      pathName yview index
      pathName yview moveto fraction
      pathName yview scroll number what
  省略時設定の束縛 DEFAULT BINDINGS
  SEE ALSO
  KEYWORDS

### NAME

listbox — 品目リストの部品 '列挙箱' を生成し操作する Create and manipulate 'listbox' item list widgets

### 構文 SYNOPSIS

listbox pathName ?options?

### STANDARD OPTIONS

-background or -bg, background, Background
-borderwidth or -bd, borderWidth, BorderWidth
-cursor, cursor, Cursor
-disabledforeground, disabledForeground, DisabledForeground
-exportselection, exportSelection, ExportSelection
-font, font, Font
-foreground or -fg, foreground, Foreground
-highlightbackground, highlightBackground, HighlightBackground
-highlightcolor, highlightColor, HighlightColor
-highlightthickness, highlightThickness, HighlightThickness
-justify, justify, Justify
-relief, relief, Relief
-selectbackground, selectBackground, Foreground
-selectborderwidth, selectBorderWidth, BorderWidth
-selectforeground, selectForeground, Background
-setgrid, setGrid, SetGrid
-takefocus, takeFocus, TakeFocus
-xscrollcommand, xScrollCommand, ScrollCommand
-yscrollcommand, yScrollCommand, ScrollCommand

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

Command-Line Name: -activestyle
Database Name: activeStyle
Database Class: ActiveStyle
  活動状態の要素を描く様式を指定する｡これは dotbox (活動状態の要素回りに注目環を示す)か､ none (活動状態の要素の指示はしない) か underline (活動状態の要素に下線を引く)の内の一つでなければならない｡無為設定はWindowsでは underline ､それ以外では dotbox である｡ Specifies the style in which to draw the active element. This must be one of dotbox (show a focus ring around the active element), none (no special indication of active element) or underline (underline the active element). The default is underline on Windows, and dotbox elsewhere.

Command-Line Name: -height
Database Name: height
Database Class: Height
  窓に対して望ましい高さを行単位で指定する｡もし零かそれ以下の場合､窓の望ましい高さは列挙箱内の全ての要素を保有するに丁度足る大きさにされる｡ Specifies the desired height for the window, in lines. If zero or less, then the desired height for the window is made just large enough to hold all the elements in the listbox.

Command-Line Name: -listvariable
Database Name: listVariable
Database Class: Variable
  大域変数の名前を指定する｡変数の値は部品の内部に展示されるリストである; もし､変数の値が変化すると部品は自動的に更新され自身が新しい値に反映される｡不適切なリストの値の変数を -listvariable に代入する試みは不都合を発生する｡ -listvariable として使用中の変数を削除する試みは失敗するが不都合は発生しない｡ Specifies the name of a global variable. The value of the variable is a list to be displayed inside the widget; if the variable value changes then the widget will automatically update itself to reflect the new value. Attempts to assign a variable with an invalid list value to -listvariable will cause an error. Attempts to unset a variable in use as a -listvariable will fail but will not generate an error.

Command-Line Name: -selectmode
Database Name: selectMode
Database Class: SelectMode
  選択を操作する為の幾つかの方式の内の一つを指定する｡この指示項目の値は任意であるが､無為設定の束縛は single か browse か multiple か extended のどれかであることを期待している; 無為設定の値は browse｡ 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.

Command-Line Name: -state
Database Name: state
Database Class: State
  列挙箱に対して二つの状態の内の一つを指定する: normal か disabled ｡もし列挙箱が不能の場合､品目は挿入も消去もできないし､品目は -disabledforeground 色で描かれ､選択は修正不可能で明示されない(但し選択の情報は残される)｡ Specifies one of two states for the listbox: normal or disabled. If the listbox is disabled then items may not be inserted or deleted, items are drawn in the -disabledforeground color, and selection cannot be modified and is not shown (though selection information is retained).

Command-Line Name: -width
Database Name: width
Database Class: Width
  窓に対して望ましい幅を文字単位で指定する｡もし文字形状が一定の幅を有しない場合は文字の幅 “0” が文字から画面単位の変換に使用される｡もし､零かそれ以下の場合､窓の望ましい幅は列挙箱内の全ての要素を保有するに丁度足る大きさにされる｡ Specifies the desired width for the window in characters. If the font does not have a uniform width then the width of the character “0” is used in translating from character units to screen units. If zero or less, then the desired width for the window is made just large enough to hold all the elements in the listbox.

### 説明 DESCRIPTION

listbox 命令は(与えられたpathName 引数によって)新しい窓を生成し､それを列挙箱部品にする｡上に述べた追加的な指示項目は命令行或は､その色や字形や文書や立体感の様な文書の外観を構成設定する追加的な基礎データの中で指定される｡listbox 命令は新しい窓の経路名を返す｡この命令が起動された時､ pathName の名前の窓が存在してはならないが､pathName の親は実在しなければならない｡ The listbox command creates a new window (given by the pathName argument) and makes it into a listbox widget. Additional options, described above, may be specified on the command line or in the option database to configure aspects of the listbox such as its colors, font, text, and relief. The listbox command returns its pathName argument. At the time this command is invoked, there must not exist a window named pathName, but pathName's parent must exist.

列挙箱は部品であって文字列のリストを１行に一つ表示する｡初めに作成されるとき､新しい列挙箱に要素はない｡要素は下に述べる部品命令を使って追加あるいは削除される｡更に､一つ或はそれ以上の要素が下に述べる様に選択できる｡もし列挙箱が選択を移出していると( exportSelection 指示項目を参照されたい)､選択を処理する標準 X11 通信規約を遵守する｡列挙箱選択はSTRING型として利用できる; 選択の値は､選択された要素の文書になり､要素を分離している改行文字も伴う｡ A listbox is a widget that displays a list of strings, one per line. When first created, a new listbox has no elements. Elements may be added or deleted using widget commands described below. In addition, one or more elements may be selected as described below. If a listbox is exporting its selection (see -exportselection option), then it will observe the standard X11 protocols for handling the selection. Listbox selections are available as type STRING; the value of the selection will be the text of the selected elements, with newlines separating the elements.

列挙箱窓内の全ての要素を一度に表示する必要はない; 下に記述した命令は窓内の視野を変更することに使用できる｡列挙箱は標準 xScrollCommand と yScrollCommand 指示項目を使って両方向に摺動することを許容する｡それは下に述べるように走査も 運用している｡ It is not necessary for all the elements to be displayed in the listbox window at once; commands described below may be used to change the view in the window. Listboxes allow scrolling in both directions using the standard -xscrollcommand and -yscrollcommand options. They also support scanning, as described below.

### 参照番号 INDICES

列挙箱に関わる多くの部品命令は引数として一つ或はそれ以上の参照番号をとる｡参照番号は列挙箱の特定の要素を次のどれかの方法で指定する: Many of the widget commands for listboxes take one or more indices as arguments. An index specifies a particular element of the listbox, in any of the following ways:

number
  要素を数字の参照番号で指定する､ここで 0 は列挙箱の初めの要素に相当する｡ Specifies the element as a numerical index, where 0 corresponds to the first element in the listbox.

active
  位置の遊走子を有する要素を指し示す｡この要素は列挙箱が鍵盤の注目を有する時 -activestyle によって指定された様に表示され､それは activate 部品命令を使って指定される｡ Indicates the element that has the location cursor. This element will be displayed as specified by -activestyle when the listbox has the keyboard focus, and 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.

end
  列挙箱の末尾を指し示す｡大部分の命令はこれを列挙箱内の最後の要素として参照するが､ index や insert の様な少数の命令ではこれは最後の要素の直ぐ後の要素を 参照する｡ Indicates the end of the listbox. For most commands this refers to the last element in the listbox, but for a few commands such as index and insert it refers to the element just after the last one.

@x,y
  x と y (画素単位の座標)で指定される列挙箱窓内の位置を覆う要素を指し示す｡もし､その位置がどの要素も覆ってない場合､その点に最も近い要素が使われる｡ Indicates the element that covers the point in the listbox window specified by x and y (in pixel coordinates). If no element covers that point, then the closest element to that point is used.

索引は､命令string indexに関する､ 単純な整数索引算術とendへの相対索引を伴う､ 同じ単純な解釈に対応している｡ 下に述べる部品命令内で､ index と first と last と名前付けられた引数は常に上述の形式の内の一つの形式の参照番号の文書を含む｡ Indexes support the same simple interpretation as for the command string index, with simple integer index arithmetic and indexing relative to end. In the widget command descriptions below, arguments named index, first, and last always contain text indices in one of the above forms.

### 部品命令 WIDGET COMMAND

listbox 命令は名前が pathName の新しい Tcl 命令を生成する｡この命令は部品上の種々の操作の起動に使われる｡次の一般的形式を有する: The listbox 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 ...?

option と arg は命令の正確な振舞いを定める｡次の命令が列挙箱部品について可能である: Option and the args determine the exact behavior of the command. The following commands are possible for listbox widgets:

pathName activate index
  index により指し示される要素を活動状態の要素に設定する｡もし index が列挙箱内の要素の範囲の外であると最も近い要素が活動状態にされる｡部品が入力の注目を有する時､活動状態の要素は -activestyle の指定に従って描かれる､そしてその参照番号は index として active を指定して取戻される｡ Sets the active element to the one indicated by index. If index is outside the range of elements in the listbox then the closest element is activated. The active element is drawn as specified by -activestyle when the widget has the input focus, and its index may be retrieved with the index active.

pathName bbox index
  index で与えられる要素の中の文書の囲み箱を記述する４つの数のリストを返す｡初めの二つの要素は文字に覆われた画面領域の左上隅の x と y 座標(部品に相対的な画素単位)で最後の二つは文字の幅と高さで､画素単位である｡もし index によって与えられるどの部分も画面上に可視でないか､ index が実在しない要素を指しているか､であると､結果は空リストである｡もし､要素が部分的に可視であると､結果は要素の全領域であり可視でないどの部分も含む｡ Returns a list of four numbers describing the bounding box of the text in the element given by index. The first two elements of the list give the x and y coordinates of the upper-left corner of the screen area covered by the text (specified in pixels relative to the widget) and the last two elements give the width and height of the area, in pixels. If no part of the element given by index is visible on the screen, or if index refers to a non-existent element, then the result is an empty string; if the element is partially visible, the result gives the full area of the element, including any parts that are not visible.

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

pathName configure ?option? ?value option value ...?
  部品の構成設定できる指示項目の値を問合せ又は修正する｡もし option が指定されないと､ pathName について利用できる全ての指示項目を記述したリストを返す(このリストの書式の情報については Tk_ConfigureInfo を参照されたい)｡もし value なしで option が指定されると､本命令は option の名前のものを記述したリストを返す(このリストは option の指定なしで返った値の該当箇所の小リストに等しい)｡もし､一つ或はそれ以上のoption-value 対が指定されると､命令は､与えられた指示項目を与えられた値に修正する; この場合､命令は空文字列を返す｡ option はlistbox 命令が受入れるどの値を有していてもよい｡ Query or modify the configuration options of the widget. If no option is specified, returns a list describing all of the available options for pathName (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 listbox command.

pathName curselection
  現在選択されている列挙箱内の全ての要素の数的行番号を含むリストを返す｡もし列挙箱内のどの要素も選択されてないと空文字列が返される｡ Returns a list containing the numerical indices of all of the elements in the listbox that are currently selected. If there are no elements selected in the listbox then an empty string is returned.

pathName delete first ?last?
  列挙箱の一つ或はそれ以上の要素を削除する｡ first と last は削除する為の範囲の最初と最後を指定する行番号である｡もし last が指定されないとその無為設定は first であり､即ち一つの要素が削除される｡ Deletes one or more elements of the listbox. First and last are indices specifying the first and last elements in the range to delete. If last is not specified it defaults to first, i.e. a single element is deleted.

pathName get first ?last?
  もし last が省略されると first で指定される列挙箱の要素の内容が返るか､もし first が実在しない要素を参照していると空文字列が返る｡もし last が指定されるとこの命令は first と last とその間の列挙箱の全てが要素のリストを返す｡ first と last の両方は行番号の為のどの標準的な形式でもよい｡ If last is omitted, returns the contents of the listbox element indicated by first, or an empty string if first refers to a non-existent element. If last is specified, the command returns a list whose elements are all of the listbox elements between first and last, inclusive. Both first and last may have any of the standard forms for indices.

pathName index index
  index に相当する整数の行番号の値を返す｡もし index が end の場合､返る値は列挙箱内の要素の個数である(最後の要素の行番号ではない)｡ Returns the integer index value that corresponds to index. If index is end the return value is a count of the number of elements in the listbox (not the index of the last element).

pathName insert index ?element element ...?
  零かそれ以上の新しい要素をリストの index で与えられる要素の直前に挿入する｡もし index が end として指定される場合､新しい要素はリストの末尾に追加される｡空文字列を返す｡ Inserts zero or more new elements in the list just before the element given by index. If index is specified as end then the new elements are added to the end of the list. Returns an empty string.

pathName itemcget index option
  option によって与えられる構成設定指示項目の品目の値を返す｡ option は listbox itemconfigure 命令によって受入れられるどの値を有してもよい｡ Returns the current value of the item configuration option given by option. Option may have any of the values accepted by the itemconfigure command.

pathName itemconfigure index ?option? ?value? ?option value ...?
  列挙箱の構成設定できる指示項目の値を問合せ又は修正する｡もし option が指定されないと､ pathName について利用できる全ての指示項目を記述したリストを返す(このリストの書式の情報については Tk_ConfigureInfo を参照されたい)｡もし value なしで option が指定されると､その名前の指示項目を記述したリストが返る(このリストは､ option を指定しない時に返るリストの部分リストになっている)｡もし､一つ或はそれ以上のoption-value 対が指定されると､命令は､与えられた指示項目を与えられた値に修正する; この場合､命令は空文字列を返す｡次の指示項目は現在次の品目が運営されている｡ Query or modify the configuration options of an item in the listbox. If no option is specified, returns a list describing all of the available options for the item (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. The following options are currently supported for items:

  -background color
    color は品目を表示する時に使用する背景の色を指定する｡ Tk_GetColor 命令によって受入れられるどの値を有してもよい｡ Color specifies the background color to use when displaying the item. It may have any of the forms accepted by Tk_GetColor.

  -foreground color
    color は品目を表示する時に使用する前景の色を指定する｡ Tk_GetColor 命令によって受入れられるどの値を有してもよい｡ Color specifies the foreground color to use when displaying the item. It may have any of the forms accepted by Tk_GetColor.

  -selectbackground color
    color は選択されている品目を表示する時に使用する背景の色を指定する｡ Tk_GetColor 命令によって受入れられるどの値を有してもよい｡ color specifies the background color to use when displaying the item while it is selected. It may have any of the forms accepted by Tk_GetColor.

  -selectforeground color
    color は選択されている品目を表示する時に使用する前景の色を指定する｡ Tk_GetColor 命令によって受入れられるどの値を有してもよい｡ color specifies the foreground color to use when displaying the item while it is selected. It may have any of the forms accepted by Tk_GetColor.

pathName nearest y
  列挙箱窓の内部の y-軸座標を与えられ､この命令はその y-軸座標に最も近い(可視の)列挙箱内の要素の行番号を返す｡ Given a y-coordinate within the listbox window, this command returns the index of the (visible) listbox element nearest to that y-coordinate.

pathName scan option args
  この命令は列挙箱の捜査を実装する為に使われる｡ option により二つの形式を有す: This command is used to implement scanning on listboxes. 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 listbox 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 引数との距離を計算する｡次に座標の距離の 10 倍に視野を調整する｡この命令は､典型的には部品内のマウスの移動行事に結合しており､その窓を高速でよぎってリストを引っ張る効果を産出す｡返り値は空文字列｡ 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 10 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 listbox so that the element given by index is visible. If the element is already visible then the command has no effect; if the element is near one edge of the window then the listbox scrolls to bring the element into view at the edge; otherwise the listbox scrolls to center the element.

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

  pathName selection anchor index
    index によって与えられる要素に選択錨を設定する｡もし index が実在しない要素を参照すると最も近い要素が使われる｡選択錨は選択の末尾であり､それはマウスを使って選択を引張り出している間は固定されている｡ anchor の指定は錨要素の指定に使用される｡ Sets the selection anchor to the element given by index. If index refers to a non-existent element, then the closest element is used. 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 element.

  pathName selection clear first ?last?
    first と last と､その間の要素は､どれでも､もし選択されていると､選択が解除される｡ この範囲の外の要素の選択状態は変わらない｡ 　　 If any of the elements between first and last (inclusive) are selected, they are deselected. The selection state is not changed for elements outside this range.

  pathName selection includes index
    もし index により指定されている要素が現在選択されていると 1 を､そうでないと 0 を返す｡ Returns 1 if the element indicated by index is currently selected, 0 if it is not.

  pathName selection set first ?last?
    first と last とその間の範囲の全ての要素を選択する､範囲外の要素の選択状態に影響を与えない｡ Selects all of the elements in the range between first and last, inclusive, without affecting the selection state of elements outside that range.

pathName size
  列挙箱内の要素の合計数を表す十進数文字列を返す｡ Returns a decimal string indicating the total number of elements in the listbox.

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 listbox'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 によって与えられる文字が窓の左側端に表示されるように窓内の視野を調節する｡文字の位置は文字 0 の幅によって定義される｡ Adjusts the view in the window so that the character position given by index is displayed at the left edge of the window. Character positions are defined by the width of the character 0.

  pathName xview moveto fraction
    列挙箱の文書の合計の幅の fraction が窓の左に画面外になるように窓内の視野を調節する｡ fraction は 0 と 1 の間の小数でなければならない｡ Adjusts the view in the window so that fraction of the total width of the listbox 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 が pages であると､ number の画面幅で視野を調節する｡もし number が負なら更なる左の文字が可視になり｡もし number が正なら更なる右の文字が可視になる｡もし what が units である場合､視野は右か左に number 個の単位文字(文字「0」の幅)で画面上で調節する｡ This command shifts the view in the window left or right according to number and what. Number must be an integer or a float, but if it is a float then it is converted to an integer, rounded away from 0. What must be either pages or units or an abbreviation of one of these. If what 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. If what is units, the view adjusts left or right by number character units (the width of the 0 character) on the display.

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 listbox element at the top of the window, relative to the listbox as a whole (0.5 means it is halfway through the listbox, for example). The second element gives the position of the listbox element just after the last one in the window, relative to the listbox 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 element given by index is displayed at the top of the window.

  pathName yview moveto fraction
    窓の文書の全体の fraction が窓の左端に現れるように窓内の視野を調節する｡ 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 listbox, 0.33 indicates the element one-third the way through the listbox, and so on.

  pathName yview scroll number what
    この命令は窓内の視野を number と what に従って上又は下に調節する｡ number は整数か浮動小数でなければならない､但し､浮動小数の場合は､四捨五入され､整数に変換される｡ what は units か pages かでなければならない｡もし what が units である場合､視野は上か下に number 行調節する; もし pages であると､ number の画面幅で視野を調節する｡もし number が負なら初めの要素が可視になり｡もし number が正なら後の要素が可視になる｡ This command adjusts the view in the window up or down according to number and what. Number must be an integer or a float, but if it is a float then it is converted to an integer, rounded away from 0. What must be either pages or units. If what is pages then the view adjusts by number screenfuls. If number is negative then earlier elements become visible; if it is positive then later elements become visible. If what is units, the view adjusts up or down by number lines.

### 省略時設定の束縛 DEFAULT BINDINGS

Tk は自動的に列挙箱の為の級束縛を生成しそれは Motif に準じた挙動を与える｡列挙箱の多くの挙動はその -selectmode 指示項目によって定められ､それは選択を扱う四つの様式のうちの一つを選択する｡ Tk automatically creates class bindings for listboxes that give them Motif-like behavior. Much of the behavior of a listbox is determined by its -selectmode option, which selects one of four ways of dealing with the selection.

もし選択様式が single か browse であると､列挙箱のたかだか一つの要素が一度に選択可能である｡どちらの様式でも､要素上の釦１の軽叩がそれを選択しそれ以外の選択された品目を選択解除する｡ browse 様式では釦１を使って選択を曳き摺ることが可能である｡釦１上では､列挙箱は､もし normal 状態を有していれば､注目をも取ることになる｡ If the selection mode is single or browse, at most one element can be selected in the listbox at once. In both modes, clicking button 1 on an element selects it and deselects any other selected item. In browse mode it is also possible to drag the selection with button 1. On button 1, the listbox will also take focus if it has a normal state.

もし選択様式が multiple か extended であると､一度に幾つの数の要素が選択されてよく､不連続な範囲でもよい｡ multiple 様式では､要素上の釦１の軽叩の連続が､どの他の要素にも影響を与えることなく､要素の選択と非選択を往復させる｡ extended 様式では､要素上の釦１の押下はそれを選択し､それ以外の全てを非選択にする､そしてマウスの下の要素に錨を設定する; マウス釦１を下ろして曳き摺ると､設定は錨とマウスの下の要素とその間の全ての要素を含むように拡張する｡ If the selection mode is multiple or extended, any number of elements may be selected at once, including discontiguous ranges. In multiple mode, clicking button 1 on an element toggles its selection state without affecting any other elements. In extended mode, pressing button 1 on an element selects it, deselects everything else, and sets the anchor to the element under the mouse; dragging the mouse with button 1 down extends the selection to include all the elements between the anchor and the element under the mouse, inclusive.

大部分の人は一つの選択のためには browse 様式を､多数の選択の為には extended 様式を使うことを望む; 他の様式は特殊な状況でのみ便利である｡ Most people will probably want to use browse mode for single selections and extended mode for multiple selections; the other modes appear to be useful only in special situations.

列挙箱内の選択された項目の群が鍵盤やマウスを通じて使用者によって更新されたときは何時でも､仮想行事 <<ListboxSelect>> が生成される｡ pathName selection 命令による調整操作ではこの仮想行事は生成されない｡ この行事を列挙箱内の選択の何かの変化に気付かせることに束縛することは容易である｡[訳註 event命令参照]　　　　 Any time the set of selected item(s) in the listbox is updated by the user through the keyboard or mouse, the virtual event <<ListboxSelect>> will be generated. This virtual event will not be generated when adjusting the selection with the pathName selection command. It is easiest to bind to this event to be made aware of any user changes to listbox selection.

上の挙動の加えて､次の追加的挙動が省略時設定の束縛により定義されている: In addition to the above behavior, the following additional behavior is defined by the default bindings:

1. 拡張 様式では､選択範囲はシフト鍵を押下しながら釦１を押して調整可能である: これは､錨とマウスの位置にある要素とその間にある要素が選択を構成する様に修正する｡錨の反対側の新しい選択の端は釦を押しながら曳き摺ることが可能である｡ In extended mode, the selected range can be adjusted by pressing button 1 with the Shift key down: this modifies the selection to consist of the elements between the anchor and the element under the mouse, inclusive. The un-anchored end of this new selection can also be dragged with the button down.

2. 拡張 様式では､ Ctrl 鍵押下と共に釦１を押すことで巡回往復操作が始まる: 錨がマウスの下の要素に設定され､次に､その選択状態が逆転する｡他の要素の選択状態は変化しない｡もし､マウスが釦１を押したまま曳摺られると､マウスの下と錨の間の要素の選択状態は錨の要素の状態と同じに設定される; 全ての他の要素の選択状態は､巡回往復操作が始まる前の状態に留まる｡ In extended mode, pressing button 1 with the Control key down starts a toggle operation: the anchor is set to the element under the mouse, and its selection state is reversed. The selection state of other elements is not changed. If the mouse is dragged with button 1 down, then the selection state of all elements between the anchor and the element under the mouse is set to match that of the anchor element; the selection state of all other elements remains what it was before the toggle operation began.

3. もし釦１を押したままマウスが列挙箱の外に離れると､窓がマウスから遠ざかる方向に摺動され､マウスの側の画面外に使われた箇所の情報を可視にする｡その摺動はマウスが再度窓に入るか､釦が離されるか､列挙箱の末尾に到達するか､するまで継続する｡ If the mouse leaves the listbox window with button 1 down, the window scrolls away from the mouse, making information visible that used to be off-screen on the side of the mouse. The scrolling continues until the mouse re-enters the window, the button is released, or the end of the listbox is reached.

4. マウス釦2は走査にも使われる｡もし押して列挙箱の上を曳き摺ると､列挙箱の内容が高速度でマウスの移動する方向に移動する｡ Mouse button 2 may be used for scanning. If it is pressed and dragged over the listbox, the contents of the listbox drag at high speed in the direction the mouse moves.

5. もし上向又は下向鍵が押されると､場所の遊走子(活性な要素)が上か下に一つの要素分移動する｡もし選択様式が browse か extended であると､新しい活性な要素が選択され全ての他の要素は非選択になる｡ extended の様式では新しい活性な要素は選択の錨になる｡ If the Up or Down key is pressed, the location cursor (active element) moves up or down one element. If the selection mode is browse or extended then the new active element is also selected and all other elements are deselected. In extended mode the new active element becomes the selection anchor.

6. extended の様式では､シフト-上向き鍵とシフト-下向き鍵は場所の遊走子(活性な要素)が上か下に一つの要素分移動し､マウスが釦１を使った曳き摺りと同じ方式で選択要素を拡張する｡ In extended mode, Shift-Up and Shift-Down move the location cursor (active element) up or down one element and also extend the selection to that element in a fashion similar to dragging with mouse button 1.

7. 左向き鍵と右向き鍵は列挙箱の視野を左又は右に文字 0 の幅だけ摺動する｡コントロール-左向き鍵とコントロール-右向き鍵は列挙箱の視野を左又は右に窓の幅だけ摺動する｡コントロール-Prior鍵とコントロール-Next鍵も列挙箱の視野を左又は右に窓の幅だけ摺動する｡ The Left and Right keys scroll the listbox view left and right by the width of the character 0. Control-Left and Control-Right scroll the listbox view left and right by the width of the window. Control-Prior and Control-Next also scroll left and right by the width of the window.

8. Prior鍵とNext鍵は列挙箱の視野を上か下に１頁(窓の高さ)摺動する｡ The Prior and Next keys scroll the listbox view up and down by one page (the height of the window).

9. Prior鍵とNext鍵は列挙箱の視野をそれぞれ､左と右に端まで摺動する｡ The Home and End keys scroll the listbox horizontally to the left and right edges, respectively.

10. コントロール-Home鍵は位置の遊走子を列挙箱の最初の要素に置き､それを選択し､列挙箱内のそれ以外の全てを非選択にする｡ Control-Home sets the location cursor to the first element in the listbox, selects that element, and deselects everything else in the listbox.

11. コントロール-End鍵は位置の遊走子を列挙箱の最後の要素に置き､それを選択し､列挙箱内のそれ以外の全てを非選択にする｡ Control-End sets the location cursor to the last element in the listbox, selects that element, and deselects everything else in the listbox.

12. extended の様式では､コントロール-Shift-Home鍵は選択を列挙箱の最初の要素にまで拡張し､コントロール-Shift-End鍵は選択を列挙箱の最後の要素にまで拡張する｡ In extended mode, Control-Shift-Home extends the selection to the first element in the listbox and Control-Shift-End extends the selection to the last element.

13. multiple の様式では､コントロール-Shift-Home鍵は位置の遊走子を列挙箱の最初の要素に移動し､コントロール-Shift-End鍵は位置の遊走子を列挙箱の最後の要素に移動する｡ In multiple mode, Control-Shift-Home moves the location cursor to the first element in the listbox and Control-Shift-End moves the location cursor to the last element.

14. スペース鍵と選択鍵は恰もその要素の上でマウスが釦１が押されたかの様に遊走子のある要素を選択にさせる｡ The space and Select keys make a selection at the location cursor (active element) just as if mouse button 1 had been pressed over this element.

15. extended の様式では､コントロール-Shift-スペース鍵とシフト-選択鍵は恰もシフト鍵と共に釦１が押されたかの様に選択を活性要素に拡張する｡ In extended mode, Control-Shift-space and Shift-Select extend the selection to the active element just as if button 1 had been pressed with the Shift key down.

16. extended の様式では､Esc鍵は最も最近に選択を解除し列挙箱内の選択範囲の全ての要素を元の状態に戻す｡ In extended mode, the Escape key cancels the most recent selection and restores all the elements in the selected range to their previous selection state.

17. コントロール-斜線鍵は部品内の全てを選択する､但し single と browse の様式では､活性な要素を選択し､それ以外の全てを非選択にする｡ Control-/ selects everything in the widget, except in single and browse modes, in which case it selects the active element and deselects everything else.

18. コントロール-逆斜線鍵は部品内の全てを非選択にする､但し browse の様式では､なにも効果を有さない｡ Control-backslash deselects everything in the widget, except in browse mode where it has no effect.

19. F16 鍵(多くのSun 社の装置では Copy と表示される)又はメタ-w 鍵 は部品内の選択をそこに選択があれば､臨時板に複写する｡ The F16 key (labelled Copy on many Sun workstations) or Meta-w copies the selection in the widget to the clipboard, if there is a selection.

列挙箱の挙動は個別の部品に対する新しい束縛の定義により､または級の束縛の再定義により､変更可能である｡ The behavior of listboxes can be changed by defining new bindings for individual widgets or by redefining the class bindings.

### SEE ALSO

ttk::treeview

### KEYWORDS

listbox, widget
Copyright © 1990 The Regents of the University of California.
Copyright © 1994-1997 Sun Microsystems, Inc.