NAME
  ComboBox - ComboBox widget

生成 CREATION
  ComboBox pathName ?option value...?

OPTIONS from ArrowButton

  -background or -bg | -disabledforeground
  -foreground or -fg | -state

OPTIONS from Entry

  -command | -disabledforeground
  -dragenabled | -dragendcmd
  -dragevent | -draginitcmd
  -dragtype | -dropcmd
  -dropenabled | -dropovercmd
  -droptypes | -editable
  -entrybg (see -background) | -entryfg (see -foreground)
  -exportselection | -font
  -helptext | -helptype
  -helpvar | -highlightbackground
  -highlightcolor | -highlightthickness
  -insertbackground | -insertborderwidth
  -insertofftime | -insertontime
  -insertwidth | -justify
  -selectbackground | -selectborderwidth
  -selectforeground | -show
  -state | -takefocus
  -text | -textvariable
  -width | -xscrollcommand

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

  -autocomplete | -autopost
  -bwlistbox | -expand
  -height | -hottrack
  -images | -listboxwidth
  -modifycmd | -postcommand
  -values

部品命令 WIDGET COMMAND
  pathName bind ?arg...?
  pathName cget option
  pathName clearvalue
  pathName configure ?option? ?value option value ...?
  pathName get
  pathName getentry
  pathName getlistbox
  pathName getvalue
  pathName icursor index
  pathName post
  pathName setvalue index
  pathName unpost

説明 DESCRIPTION

選択入力箱部品は使用者に values 指示項目によって与えられるリストが含む値を選択することを可能にさせる｡可能な値のリストは矢印釦を押すか選択入力箱の校正可能値が偽値の場合は入口を軽叩することにより跳び出す｡もし､校正可能値が真値で且つ入口に注目がある場合は､使用者はその値を修正する為に頂か底の矢印鍵を押すことができる｡もし現在の値が厳密にリスト内の値と合致すると､リスト内のそれ以前の(頂の矢印鍵に)又はその次の(底の矢印鍵に)値が表示される｡もし､現在の値がリストの最初の値に合致する場合､この値が表示される｡もし現在の値がどれにも合致しない場合､最初の値が表示される｡ ComboBox widget enables the user to select a value among a list given by the values option. The list of possible values can be popped by pressing the ArrowButton or by clicking in the entry when editable value of the ComboBox is false.
If editable value of the ComboBox is true and the entry has the focus, the user can press the top and bottom arrow keys to modify its value. If the current value exactly match a value in the list, then the previous (for top arrow key) or then next (for bottom arrow key) value in the list is displayed. If the current value match the beginning of a value in the list, then this value is displayed. If the current value doesnt match anything, then the first value is displayed.

WIDGET-SPECIFIC OPTIONS

-autocomplete
  選択入力箱が使用者型として入力欄の値を自動補完すべきか否かを指定する｡もし真値なら､選択入力箱は入力へ使用者の型としてその値を見出す値を補填する｡ Specifies whether or not the combobox should attempt to auto-complete the value in the entry field as the user types. If true, the combobox will fill in a value that it finds in its value list as the user types into the entry.

-autopost
  選択入力箱は使用者の打鍵に従って落下を送付すべきか否かを指定する｡真値の場合､選択入力箱は､使用者入力に最も近く合致する入力を送付し､そこに摺動することになる｡ Specifies whether or not the combobox should post the drop down as the user types. If true, the combobox will post and scroll to the entry that most closely matches the user entry.

-bwlistbox
  選択入力箱は､その落下の中で標準 Tk 指示項目に代りに､ BWidget 列挙箱を使うべきことを指定する｡この指示項目は -images 指示項目が空文字列でない場合着てによって可能にする｡ Specifies that the combobox should use a BWidget listbox in its drop down instead of the standard Tk option. This option is enabled by default if the -images option is not empty.

-expand
  窓に関する拡張の振舞の値を指定する｡それは none (既定) か tab でなければならない｡もし tab が指定されると､-values の中の他の値に基づく現在の値の拡張の試みに､ Tab の 束縛が追加される｡ Specifies the value expansion behavior for the window. It must be none (default) or tab. If tab is specified, then a Tab binding is added to attempt to expand the current value based on the other values in -values.

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

-hottrack
  落下列挙箱内の選択はマウス遊走子の動きに連れ従うことになる｡ The selection in the drop down listbox will follow the mouse cursor as it moves.

-images
  -values 指示項目に対応する影像のリスト｡それぞれの影像は落下内の値の次に描かれる事になる｡この指示項目は影像の展示の必要性に応じて既定によって-bwlistbox を可能にする｡ A list of images that correspond to the -values option. Each image will be drawn next to its value in the drop down. This option enables the -bwlistbox by default as it is needed to display images.

-listboxwidth
  落下内の列挙箱の巾を指定する｡選択箱と同じ寸法が既定｡ Specifies the width of the listbox in the drop down. Defaults to the same size as the combobox.

-modifycmd
  列挙箱を選択するか矢印鍵を押して選択入力箱の値を使用者が修正する時に呼ばれる Tcl 命令を指定する｡ Specifies a Tcl command called when the user modify the value of the ComboBox by selecting it in the listbox or pressing arrow key.

-postcommand
  選択入力箱の列挙箱が対応付けされる前に呼出される Tcl 命令を指定する｡ Specifies a Tcl command called before the listbox of the ComboBox is mapped.

-values
  選択入力箱の列挙箱内に展示すべき値を指定する｡ Specifies the values to display in the listbox of the ComboBox.

WIDGET COMMAND

pathName bind ?arg...?
  入力部品上に束縛を設定する｡ Set bindings on the entry widget.

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

pathName clearvalue
  選択入力箱の現在の文書を解消する｡ Clears the current text of the ComboBox.

pathName configure ?option? ?value option value ...?
  部品の構成設定指示項目を問合せ又は修正する｡もしどの option も指定されないと､pathNameに関する利用できる全ての指示項目を記述するリストを返す｡もし option が value無しに指定されると､本命令は option と名付けられたものを記述するリストを返す(このリストはoptionが何も指定されない場合に返される値の対応する仔リストに等しくなる)｡もし､一つ或はそれ以上の option-value 対が指定されると､本命令は与えられた部品指示項目が与えらえた値を有するよう修正する; この場合､本命令は空文字列を返す｡option は生成命令によって受容れられるどのような値も採り得る｡読出し専用指示項目は修正されない｡ 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. 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 creation command. Read-only options are not be modified.

pathName get
  現在の入力箱の内容を返す｡ Returns the current contents of the entry.

pathName getentry
  入力部品に含まれる経路を返す｡ Returns the path to the contained entry widget.

pathName getlistbox
  落下内の列挙箱への経路を返す｡ Returns the path to the listbox in the drop down.

pathName getvalue
  値のリスト内の選択入力箱の現在の文書の番号を返すが､どの値にも合致しない場合は -1 を返す｡ Returns the index of the current text of the ComboBox in the list of values, or -1 if it doesn't match any value.

pathName icursor index
  index によって与えられる文字の丁度前に展示されるべき挿入遊走子について整列する｡ Arrange for the insertion cursor to be displayed just before the character given by index. Returns an empty string.

pathName post
  落下を送付する｡ Post the drop down.

pathName setvalue index
  選択入力箱の文書を値のリストの中から index によって指し示される値に設定する｡index は次の形式のどれを指定して好い: Set the text of the ComboBox to the value indicated by index in the list of values. index may be specified in any of the following forms:

  last
    値のリストの最後の要素を指定する｡ Specifies the last element of the list of values.
  first
    値のリストの最初の要素を指定する｡ Specifies the first element of the list of values.
  next
    値のリストの現在のもの(即ち､getvalue により返された値)に続く要素を指定する｡ Specifies the element following the current (ie returned by getvalue) in the list of values.
  previous
    値のリストの現在のもの(即ち､getvalue により返された値)の以前の要素を指定する｡ Specifies the element preceding the current (ie returned by getvalue) in the list of values.
  @number
    値のリストの整数番号を指定する｡ Specifies the integer index in the list of values.

pathName unpost
  落下を送付しない｡ Unpost the drop down.

束縛 BINDINGS
選択入力箱が入力の注目を有する時は既定の入力の束縛に加え､次の束縛を有する: 　 When Entry of the ComboBox has the input focus, it has the following bindings, in addition to the default Entry bindings:

- Page up 鍵は選択入力箱の値を最初の値に設定する｡ Page up set the value of the ComboBox to the first value.
- Page up 鍵 は選択入力箱の値を最後の値に設定する｡ Page down set the value of the ComboBox to the last value.
- 上向き矢印 鍵 は選択入力箱の値を以前の値に設定する｡ Arrow up set the value of the ComboBox to the previous value.
- 下向き矢印 鍵 は選択入力箱の値を次の値に設定する｡ Arrow down set the value of the ComboBox to the next value.
- -autopost が不能なら Esc鍵は列挙箱に配送しない｡ If -autopost is enabled, Escape unposts the listbox.

もし､列挙箱が対応付けされず､且つ選択入力箱が校正可能か不能の場合､入力箱上でのマウス釦1は､恰も使用者の ArrowButton 押下の如く､列挙箱の跳び出しを惹き起こす｡ If the listbox is not mapped and ComboBox is not editable or disabled, mouse button 1 on the Entry cause the listbox to popup, as if the user press the ArrowButton.