## Tcl8.6.17/Tk8.6.17 Documentation > Tk Commands > scale

### 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
    scale — 値を制御する摺動式部品の '摺動目盛' の作成と操作 Create and manipulate 'scale' value-controlled slider widgets
  構文 SYNOPSIS
  STANDARD OPTIONS
    -activebackground, activeBackground, Foreground
    -background or -bg, background, Background
    -borderwidth or -bd, borderWidth, BorderWidth
    -cursor, cursor, Cursor
    -font, font, Font
    -foreground or -fg, foreground, Foreground
    -highlightbackground, highlightBackground, HighlightBackground
    -highlightcolor, highlightColor, HighlightColor
    -highlightthickness, highlightThickness, HighlightThickness
    -orient, orient, Orient
    -relief, relief, Relief
    -repeatdelay, repeatDelay, RepeatDelay
    -repeatinterval, repeatInterval, RepeatInterval
    -takefocus, takeFocus, TakeFocus
    -troughcolor, troughColor, Background
  部品固有の指示項目 WIDGET-SPECIFIC OPTIONS
    -bigincrement, bigIncrement, BigIncrement
    -command, command, Command
    -digits, digits, Digits
    -from, from, From
    -label, label, Label
    -length, length, Length
    -resolution, resolution, Resolution
    -showvalue, showValue, ShowValue
    -sliderlength, sliderLength, SliderLength
    -sliderrelief, sliderRelief, SliderRelief
    -state, state, State
    -tickinterval, tickInterval, TickInterval
    -to, to, To
    -variable, variable, Variable
    -width, width, Width
  説明 DESCRIPTION
  部品命令 WIDGET COMMAND
    pathName cget option
    pathName configure ?option? ?value option value ...?
    pathName coords ?value?
    pathName get ?x y?
    pathName identify x y
    pathName set value
  BINDINGS
  SEE ALSO
  KEYWORDS

### NAME

scale — 値を制御する摺動式部品の '摺動目盛' の作成と操作 Create and manipulate 'scale' value-controlled slider widgets

### 構文 SYNOPSIS

scale pathName ?options?

### STANDARD OPTIONS

-activebackground, activeBackground, Foreground
-background or -bg, background, Background
-borderwidth or -bd, borderWidth, BorderWidth
-cursor, cursor, Cursor
-font, font, Font
-foreground or -fg, foreground, Foreground
-highlightbackground, highlightBackground, HighlightBackground
-highlightcolor, highlightColor, HighlightColor
-highlightthickness, highlightThickness, HighlightThickness
-orient, orient, Orient
-relief, relief, Relief
-repeatdelay, repeatDelay, RepeatDelay
-repeatinterval, repeatInterval, RepeatInterval
-takefocus, takeFocus, TakeFocus
-troughcolor, troughColor, Background

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

Command-Line Name: -bigincrement
Database Name: bigIncrement
Database Class: BigIncrement
  摺動目盛の値に “大きい” 増加による変化をもたらす対話機能; この指示項目は大きな増加の寸法を指定する｡もし指定が 0 であると､大きな増加の省略時設定は摺動目盛の範囲の 1/10 になる｡ Some interactions with the scale cause its value to change by “large” increments; this option specifies the size of the large increments. If specified as 0, the large increments default to 1/10 the range of the scale.

Command-Line Name: -command
Database Name: command
Database Class: Command
  何時であれ､部品命令経由で摺動目盛の値が変化した時に起動する Tcl 命令の名前の前半部を指定する｡実際の命令は､この指定に空白を続け､更に摺動目盛の新しい値を指し示す実数値を続けて構成される｡ Specifies the prefix of a Tcl command to invoke whenever the scale's value is changed via a widget command. The actual command consists of this option followed by a space and a real number indicating the new value of the scale.

Command-Line Name: -digits
Database Name: digits
Database Class: Digits
  摺動目盛の値を文字列に変換した時有効数字を幾つ残すべきかを指定する整数｡もし数値が零かそれ以下であると､摺動目盛は､可能な位置がことごとく異なる文字列として印刷し得ることを保障できる最小の値を拾う｡ An integer specifying how many significant digits should be retained when converting the value of the scale to a string. If the number is less than or equal to zero, then the scale picks the smallest value that guarantees that every possible slider position prints as a different string.

Command-Line Name: -from
Database Name: from
Database Class: From
  摺動目盛の左端か上端かに相当する実数｡ A real value corresponding to the left or top end of the scale.

Command-Line Name: -label
Database Name: label
Database Class: Label
  摺動目盛の札として表示する文字列｡垂直の摺動目盛では､札は摺動目盛の上端の直ぐ右に置かれる｡水平の摺動目盛では､札は摺動目盛の左端の直ぐ上に置かれる｡もしこの指示項目が空文字列として指定された場合､札は表示されない｡ A string to display as a label for the scale. For vertical scales the label is displayed just to the right of the top end of the scale. For horizontal scales the label is displayed just above the left end of the scale. If the option is specified as an empty string, no label is displayed.

Command-Line Name: -length
Database Name: length
Database Class: Length
  摺動目盛の望ましい長さを画面単位で指定する(即ち､ Tk_GetPixels に受入れられるどれかの形式で)｡垂直の摺動目盛に対してはこれは摺動目盛の高さ; 水平の摺動目盛に対してはこれは摺動目盛の幅である｡ Specifies the desired long dimension of the scale in screen units (i.e. any of the forms acceptable to Tk_GetPixels). For vertical scales this is the scale's height; for horizontal scales it is the scale's width.

Command-Line Name: -resolution
Database Name: resolution
Database Class: Resolution
  摺動目盛の為の解像度を指定する実数｡もしこの値が零より大きい場合､摺動目盛の値は､摺動目盛の目盛と端点が付けられる様に､常にこの値の偶数倍に丸められる｡もしこの値が零より小さい場合､丸めは起らない｡省略時設定は 1 (即ち､値は整数になる)｡ A real value specifying the resolution for the scale. If this value is greater than zero then the scale's value will always be rounded to an even multiple of this value, as will the endpoints of the scale. If the value is less than zero then no rounding occurs. Defaults to 1 (i.e., the value will be integral).

Command-Line Name: -showvalue
Database Name: showValue
Database Class: ShowValue
  摺動目盛の現在の値を表示するか否かを指し示す論理値を指定する｡ Specifies a boolean value indicating whether or not the current value of the scale is to be displayed.

Command-Line Name: -sliderlength
Database Name: sliderLength
Database Class: SliderLength
  摺動目盛の寸法を指定する､摺動目盛の長い寸法に沿って画面単位で測定する｡値は Tk_GetPixels に受入可能などの形式で指定してもよい｡ Specifies the size of the slider, measured in screen units along the slider's long dimension. The value may be specified in any of the forms acceptable to Tk_GetPixels.

Command-Line Name: -sliderrelief
Database Name: sliderRelief
Database Class: SliderRelief
  摺動目盛を描く時に使う立体感を指定する､譬えば raised や sunken の様に｡ Specifies the relief to use when drawing the slider, such as raised or sunken.

Command-Line Name: -state
Database Name: state
Database Class: State
  摺動目盛について､三つの状態の一つを指定する: normal か active か disabled ｡もし摺動目盛が不能であると値は変化されない且つ摺動目盛は活性にならない｡もし摺動目盛が活性であると､摘まみは -activebackground 指示項目で指定される色を遣って表示される｡ Specifies one of three states for the scale: normal, active, or disabled. If the scale is disabled then the value may not be changed and the scale will not activate. If the scale is active, the slider is displayed using the color specified by the -activebackground option.

Command-Line Name: -tickinterval
Database Name: tickInterval
Database Class: TickInterval
  実数値でなければならない｡摺動目盛の下又は左に表示される､数値の目盛の間の空間を定める｡もし 0 であると､目盛は表示されない｡ Must be a real value. Determines the spacing between numerical tick marks displayed below or to the left of the slider. The values will all be displayed with the same number of decimal places, which will be enough to ensure they are all accurate to within 20% of a tick interval. If 0, no tick marks will be displayed.

Command-Line Name: -to
Database Name: to
Database Class: To
  摺動目盛の右端か下端かに相当する実数を指定する｡この値は from 指示項目の値より大きいか小さいかである｡ Specifies a real value corresponding to the right or bottom end of the scale. This value may be either less than or greater than the -from option.

Command-Line Name: -variable
Database Name: variable
Database Class: Variable
  摺動目盛に連結した大域変数の名前を指定する｡何時であれ変数の値が変化する時は､摺動目盛はその値を反映して更新される｡何時であれ摺動目盛が対話的に操作される時は変数は摺動目盛の新しい値を反映して修正される｡ Specifies the name of a global variable to link to the scale. Whenever the value of the variable changes, the scale will update to reflect this value. Whenever the scale is manipulated interactively, the variable will be modified to reflect the scale's new value.

Command-Line Name: -width
Database Name: width
Database Class: Width
  摺動目盛 の狭い溝の望ましい寸法を画面単位で指定する(即ち､Tk_GetPixels に受容れられるどのような単位でも)｡縦方向の摺動目盛ではこれは摺動目盛の幅である; 水平方向の摺動目盛ではこれは摺動目盛の高さである｡　　　 Specifies the desired narrow dimension of the scale in screen units (i.e. any of the forms acceptable to Tk_GetPixels). For vertical scales this is the scale's width; for horizontal scales this is the scale's height.

### 説明 DESCRIPTION

scale 命令は( pathName 引数によって与えられる)新しい窓を生成し､それを摺動目盛部品にする｡上述の追加的な指示項目は命令行或は､その色や方向や立体感の様な摺動目盛の外観を構成設定する追加的な基礎データの中で指定される｡scale 命令はその pathName 引数を返す｡この命令が起動された時､ pathName の名前の窓が存在してはならないが､pathName の親は実在しなければならない｡ The scale command creates a new window (given by the pathName argument) and makes it into a scale widget. Additional options, described above, may be specified on the command line or in the option database to configure aspects of the scale such as its colors, orientation, and relief. The scale 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.

摺動目盛は矩形の溝と小さい摘まみを表示する部品である｡溝は実数の範囲に相当する( -from と -to と -resolution 指示項目により定められる)､又摘まみの位置は特定の実数を選択する｡この摘まみの位置は(それ故摺動目盛の値は)､下の BINDINGS 節に記述する様に､マウスや鍵器を使って調整される｡何時であれ､摺動目盛の値が変化した時は､他の変更に関連する部品に知らせる為に Tcl 命令が起動される( -command 指示項目を遣って)｡更に摺動目盛の値は Tcl 変数に連結もでき( -variable 指示項目を使って)､両方の変化は互いに反映する｡ A scale is a widget that displays a rectangular trough and a small slider. The trough corresponds to a range of real values (determined by the -from, -to, and -resolution options), and the position of the slider selects a particular real value. The slider's position (and hence the scale's value) may be adjusted with the mouse or keyboard as described in the BINDINGS section below. Whenever the scale's value is changed, a Tcl command is invoked (using the -command option) to notify other interested widgets of the change. In addition, the value of the scale can be linked to a Tcl variable (using the -variable option), so that changes in either are reflected in the other.

三つの注釈も摺動目盛部品に表示していもよい: 部品の上右に現れる札(水平摺動目盛の場合左上)､摘まみのすぐ左に表示される数字(水平摺動目盛の場合直ぐ上)､現在の値の直ぐ左の数字目盛の集まり(水平摺動目盛の場合直ぐ下)｡これら三つの注釈はそれぞれ構成設定指示項目を使って有効と無効になりうる｡ Three annotations may be displayed in a scale widget: a label appearing at the top right of the widget (top left for horizontal scales), a number displayed just to the left of the slider (just above the slider for horizontal scales), and a collection of numerical tick marks just to the left of the current value (just below the trough for horizontal scales). Each of these three annotations may be enabled or disabled using the configuration options.

### 部品命令 WIDGET COMMAND

scale 命令は pathName と言う名前の新しい Tcl 命令を生成する｡この命令は部品上の種々の指示項目を起動する為に使うことができる｡それは次の一般式を有する: The scale command creates a new Tcl command whose name is pathName. This command may be used to invoke various operations on the widget. It has the following general form:

    pathName option ?arg arg ...?

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

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

pathName configure ?option? ?value option value ...?
  部品の構成設定できる指示項目の値を問合せ又は修正する｡もし option が指定されないと､ pathName について利用できる全ての指示項目を記述したリストを返す(このリストの書式の情報については Tk_ConfigureInfo を参照されたい)｡もし value なしで option が指定されると､その名前の指示項目を記述したリストが返る(このリストは､ option を指定しない時に返るリストの部分リストになっている)｡もし､一つ或はそれ以上の option-value 対が指定されると､命令は､与えられた指示項目を与えられた値に修正する; この場合､命令は空文字列を返す｡ option はscale 命令が受入れるどの値を有していてもよい｡ 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 scale command.

pathName coords ?value?
  溝の中央の線に沿った value に相当する場所の x と y 座標を要素とするリストを返す｡もし value が省略された場合､摺動目盛の現在値が使われる｡ Returns a list whose elements are the x and y coordinates of the point along the centerline of the trough that corresponds to value. If value is omitted then the scale's current value is used.

pathName get ?x y?
  x も y も省略された場合は摺動目盛の現在値を返す｡ x と y が指定された場合は､部品内の画素座標を与える; 命令は与えられた画素に相当する摺動目盛の値を返す｡ x か y の内の一つが使われた場合は: 水平摺動目盛については y が無視され､垂直摺動目盛については x が無視される｡ If x and y are omitted, returns the current value of the scale. If x and y are specified, they give pixel coordinates within the widget; the command returns the scale value corresponding to the given pixel. Only one of x or y is used: for horizontal scales y is ignored, and for vertical scales x is ignored.

pathName identify x y
  与えられた x と y 座標の下に摺動目盛のどの部分があるかを指し示す文字列を返す｡返り値が slider の場合は位置が摘まみの上であることを意味する; trough1 は位置が上述の摘まみか摘まみの左であることを意味する; trough2 は位置が摘まみか摘まみの右であることを意味する｡もし位置がこれ等の要素の内の一つの上ではない場合､空文字列が返される｡ Returns a string indicating what part of the scale lies under the coordinates given by x and y. A return value of slider means that the point is over the slider; trough1 means that the point is over the portion of the slider above or to the left of the slider; and trough2 means that the point is over the portion of the slider below or to the right of the slider. If the point is not over one of these elements, an empty string is returned.

pathName set value
  この命令は摺動目盛の現在値と､摘まみが表示される位置を変更する為に起動される｡ value は摺動目盛の新しい値を与える｡もし摺動目盛が不能の場合この命令は効果を有さない｡ This command is invoked to change the current value of the scale, and hence the position at which the slider is displayed. Value gives the new value for the scale. The command has no effect if the scale is disabled.

### BINDINGS

Tk は自動的に摺動目盛の為に級束縛を作成する､それは次の省略時設定の挙動を与える｡ここで挙動は垂直と水平の摺動目盛の間で異なる時は､水平の挙動は括弧の中に記述する｡ Tk automatically creates class bindings for scales that give them the following default behavior. Where the behavior is different for vertical and horizontal scales, the horizontal behavior is described in parentheses.

1. もし釦 1 が溝内で､摺動目盛の値は -resolution 指示項目の値だけ増加又は減少し､摘まみは遊走子の方向に移動する｡もし釦が下げられて保持されると動作が自動繰返しされる｡ If button 1 is pressed in the trough, the scale's value will be incremented or decremented by the value of the -resolution option so that the slider moves in the direction of the cursor. If the button is held down, the action auto-repeats.

2. もし釦 1 が摘まみの上で押された場合､摘まみはマウスに曳き摺られ得る｡ If button 1 is pressed over the slider, the slider can be dragged with the mouse.

3. もしCtrl 鍵押下を伴って釦 1 が摘まみの上で押された場合､摘まみはマウス遊走子の方向に､その範囲の端まで全部の距離を移動する｡ If button 1 is pressed in the trough with the Control key down, the slider moves all the way to the end of its range, in the direction towards the mouse cursor.

4. もし釦 2 が押された場合､摺動目盛の値はマウスの位置に設定される｡もしマウスが釦 2 を押したまま引張られると､摺動目盛の値は引っ張りによって変更する｡ If button 2 is pressed, the scale's value is set to the mouse position. If the mouse is dragged with button 2 down, the scale's value changes with the drag.

5. 上向き鍵と左向き鍵は摘まみを上(左)に resolution 指示項目の値だけ移動させる｡ The Up and Left keys move the slider up (left) by the value of the -resolution option.

6. 下向き鍵と右向き鍵は摘まみを下(右)に resolution 指示項目の値だけ移動させる｡ The Down and Right keys move the slider down (right) by the value of the -resolution option.

7. Ctrl-上向き鍵とCtrl-左向き鍵は摘まみを上(左)に bigIncrement 指示項目の値だけ移動させる｡ Control-Up and Control-Left move the slider up (left) by the value of the -bigincrement option.

8. Ctrl-下向き鍵とCtrl-右向き鍵は摘まみを下(右)に bigIncrement 指示項目の値だけ移動させる｡ Control-Down and Control-Right move the slider down (right) by the value of the -bigincrement option.

9. Home鍵は摘まみをその範囲の上(左)端に移動させる｡ Home moves the slider to the top (left) end of its range.

10. End鍵は摘まみをその範囲の下(右)端に移動させる｡ End moves the slider to the bottom (right) end of its range.

もし摺動目盛が state 指示項目により不能にされていると上のどの束縛も何も効果を有さない｡ If the scale is disabled using the -state option then none of the above bindings have any effect.

摺動目盛の振舞いは個別の部品や級の束縛の再定義の為に新しい束縛を定義することにより変更可能である｡ The behavior of scales can be changed by defining new bindings for individual widgets or by redefining the class bindings.

### SEE ALSO

ttk::scale

### KEYWORDS

scale, slider, trough, widget
Copyright © 1990-1994 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.