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

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

  NAME
    ttk::spinbox — 文書欄枠部品の選択 　　Selecting text field widget
  構文 SYNOPSIS
  説明 DESCRIPTION
  STANDARD OPTIONS
    -class, undefined, undefined
    -cursor, cursor, Cursor
    -placeholder, placeHolder, PlaceHolder
    -placeholderforeground, placeHolderForeground, PlaceHolderForeground
    -state, state, State
    -style, style, Style
    -takefocus, takeFocus, TakeFocus
    -validate, validate, Validate
    -validatecommand, validateCommand, ValidateCommand
    -xscrollcommand, xScrollCommand, ScrollCommand
  部品固有の指示項目 WIDGET-SPECIFIC OPTIONS
    -command, command, Command
    -format, format, Format
    -from, from, From
    -increment, increment, Increment
    -to, to, To
    -values, values, Values
    -wrap, wrap, Wrap
  索引 INDICES
  妥当性確認 VALIDATION
  部品命令 WIDGET COMMAND
    pathName get
    pathName set value
  假想行事 VIRTUAL EVENTS
  様式の指示項目 STYLING OPTIONS
  SEE ALSO
  KEYWORDS

### NAME

ttk::spinbox — 文書欄枠部品の選択 　　Selecting text field widget

### 構文 SYNOPSIS

ttk::spinbox pathName ?options?

### 説明 DESCRIPTION

ttk::spinbox 部品は上昇と下降の釦を組込んだ ttk::entry 部品であり､釦は数の値の修正､又は値の組の中の選択のどちらかに使用する｡この部品は 部品により表示される値をTcl 変数に連結する為の -textvariable 指示項目の運営を含む全ての ttk::entry 部品の性質を運営する｡　　　　　　　 A ttk::spinbox widget is a ttk::entry widget with built-in up and down buttons that are used to either modify a numeric value or to select among a set of values. The widget implements all the features of the ttk::entry widget including support of the -textvariable option to link the value displayed by the widget to a Tcl variable.

### STANDARD OPTIONS

-class, undefined, undefined
-cursor, cursor, Cursor
-placeholder, placeHolder, PlaceHolder
-placeholderforeground, placeHolderForeground, PlaceHolderForeground
-state, state, State
-style, style, Style
-takefocus, takeFocus, TakeFocus
-validate, validate, Validate
-validatecommand, validateCommand, ValidateCommand
-xscrollcommand, xScrollCommand, ScrollCommand

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

Command-Line Name: -command
Database Name: command
Database Class: Command
  何時であれ旋回釦入力口が起動された時に起動される Tcl 命令を指定する｡ 　　　　　　 Specifies a Tcl command to be invoked whenever a spinbutton is invoked.

Command-Line Name: -format
Database Name: format
Database Class: Format
  -from と -to を範囲に使って文字列値を設定する時､代替書式を指定する｡これは浮動小数を書式化する様に､ %<pad>.<pad>f の書式の書式指定子でなければならない｡ 　　　　　　　　 Specifies an alternate format to use when setting the string value when using the -from and -to range. This must be a format specifier of the form %<pad>.<pad>f, as it will format a floating-point number.

Command-Line Name: -from
Database Name: from
Database Class: From
  旋回釦入力口の値について浮動小数の最小値を設定する｡これは -to と -increment と一緒に使って数的範囲を設定する｡ 　　　　　　 A floating-point value specifying the lowest value for the spinbox. This is used in conjunction with -to and -increment to set a numerical range.

Command-Line Name: -increment
Database Name: increment
Database Class: Increment
  部品の旋回釦の一つが押された時に適用される変化の値を指定する浮動小数｡上向き釦は正の増加､下向き釦は負の増加が適用される｡　　　　　　　　 A floating-point value specifying the change in value to be applied each time one of the widget spin buttons is pressed. The up button applies a positive increment, the down button applies a negative increment.

Command-Line Name: -to
Database Name: to
Database Class: To
  この部品に許容しうる最高の値を指定する浮動小数｡ -from と -increment 範囲をも参照されたい｡ 　　　　　　　　　 A floating-point value specifying the highest permissible value for the widget. See also -from and -increment. range.

Command-Line Name: -values
Database Name: values
Database Class: Values
  これは値の Tcl リストでなければならない｡もしこの指示項目が設定される場合､ -from と -to と -increment 指示項目を使用してどの範囲の設定も上書きする｡この部品は値の指定を最初の値から開始する代りに使用される｡ 　　　　　 This must be a Tcl list of values. If this option is set then this will override any range set using the -from, -to and -increment options. The widget will instead use the values specified beginning with the first value.

Command-Line Name: -wrap
Database Name: wrap
Database Class: Wrap
  適切な論理値でなければならない｡もし on の場合､旋回釦入力口は部品内の値を折り畳む｡ 　　　　　　　　 Must be a proper boolean value. If on, the spinbox will wrap around the values of data in the widget.

### 索引 INDICES

索引文字に関する情報については ttk::entry 取扱説明書を参照されたい｡ See the ttk::entry manual for information about indexing characters.

### 妥当性確認 VALIDATION

-validate と -validatecommand 指示項目の使用についての情報は取扱説明書の ttk::entry を参照されたい｡ See the ttk::entry manual for information about using the -validate and -validatecommand options.

### 部品命令 WIDGET COMMAND

次の副命令が旋回釦入力口部品に ttk::entry 部品について記述された命令の加えて可能である: The following subcommands are possible for spinbox widgets in addition to the commands described for the ttk::entry widget:

pathName get
  旋回釦入力口の現在の値を返す｡ 　　　　　　 Returns the spinbox's current value.

pathName set value
  旋回釦入力口の文字列を value に設定する｡もし -format 指示項目が既に構成設定されている場合､この書式が適用される｡もし書式化が失敗するか設定されていないか -values 指示項目が既に使用されている場合､値は直接設定される｡ 　　　　　　 Set the spinbox string to value. If a -format option has been configured then this format will be applied. If formatting fails or is not set or the -values option has been used then the value is set directly.

### 假想行事 VIRTUAL EVENTS

旋回釦入力口部品は､使用者が <Up> を押した時に假想行事 <<Increment>> を､使用者が <Down> を押した時に仮想行事 <<Decrement>> を発生する｡　　　　　　 The spinbox widget generates a <<Increment>> virtual event when the user presses <Up>, and a <<Decrement>> virtual event when the user presses <Down>.

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

ttk::spinbox の級の名前は TSpinbox である｡　　　　　　　　 The class name for a ttk::spinbox is TSpinbox.

Dynamic states: active, disabled, focus, readonly.

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

-arrowcolor color
-arrowsize amount
-background color

  旧版との互換性のためのもの､(macOSの)aqua 主題を使う時､この指示項目は -fieldbackground に値が指定されていない場合は-fieldbackground への連結として振舞う｡それ以外は無視される｡ For backwards compatibility, when using the aqua theme (for macOS), this option behaves as an alias for the -fieldbackground provided that no value is specified for -fieldbackground. Otherwise it is ignored.

-bordercolor color
-darkcolor color
-fieldbackground color
-foreground color
-insertcolor color
-insertwidth amount
-lightcolor color
-padding padding
-placeholderforeground color
-selectbackground color
-selectforeground color

幾つかの指示項目は特別の主題の為にのみ利用できる｡　　　　 Some options are only available for specific themes.

ttk 様式を如何に構成設定するかの情報は ttk::style の取扱い説明書頁を参照されたい｡　　　　　 See the ttk::style manual page for information on how to configure ttk styles.

### SEE ALSO

ttk::widget, ttk::entry, spinbox

### KEYWORDS

entry, spinbox, widget, text field
Copyright © 2008 Pat Thoyts