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

### 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::scrollbar — 摺動可能な部品の視点の制御　　Control the viewport of a scrollable widget
  構文 SYNOPSIS
  説明 DESCRIPTION
  STANDARD OPTIONS
    -class, undefined, undefined
    -cursor, cursor, Cursor
    -style, style, Style
    -takefocus, takeFocus, TakeFocus
  部品固有の指示項目WIDGET-SPECIFIC OPTIONS
    -command, command, Command
    -orient, orient, Orient
  部品命令 WIDGET COMMAND
    pathName cget option
    pathName configure ?option? ?value option value ...?
    pathName get
    pathName identify x y
    pathName instate statespec ?script?
    pathName set first last
    pathName state ?stateSpec?
  内部命令 INTERNAL COMMANDS
    pathName delta deltaX deltaY
    pathName fraction x y
  SCROLLING COMMANDS
    prefix moveto fraction
    prefix scroll number units
    prefix scroll number pages
  部品状態WIDGET STATES
  用例 EXAMPLE
  様式の指示項目 STYLING OPTIONS
  SEE ALSO
  KEYWORDS

### NAME

ttk::scrollbar — 摺動可能な部品の視点の制御　　Control the viewport of a scrollable widget

### 構文 SYNOPSIS

ttk::scrollbar pathName ?options...?

### 説明 DESCRIPTION

ttk::scrollbar 部品は､典型的には､編集されたり描かれたりするファイルの様なある種の文章を表示するように結合された窓に､連結されている｡摺動盤は摺動盤の中央部位内に摺動桿を表示し､その位置と寸法が結合した窓内での文章の可視の部分に関する情報を提供する｡摺動桿は使用者によって可視領域を制御する為に曳き摺られ得る｡主題に従って二つあるいはそれ以上の矢の釦が存在するかもしれず､これらは個別の構成単位の可視領域の摺動に使われる｡ ttk::scrollbar widgets are typically linked to an associated window that displays a document of some sort, such as a file being edited or a drawing. A scrollbar displays a thumb in the middle portion of the scrollbar, whose position and size provides information about the portion of the document visible in the associated window. The thumb may be dragged by the user to control the visible region. Depending on the theme, two or more arrow buttons may also be present; these are used to scroll the visible region in discrete units.

### STANDARD OPTIONS

-class, undefined, undefined
-cursor, cursor, Cursor
-style, style, Style
-takefocus, takeFocus, TakeFocus

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

Command-Line Name: -command
Database Name: command
Database Class: Command
  摺動盤に結合した部品内の視野の変更を評価する為の Tcl 記述譜の前置辞｡何時であれ使用者が摺動盤の操作により視野の変化を要求したときは､下の SCROLLING COMMANDS に記述した様に追加的な引数がこの指示項目の値に追記される｡ 　　　　　　　　　　　 A Tcl script prefix to evaluate to change the view in the widget associated with the scrollbar. Additional arguments are appended to the value of this option, as described in SCROLLING COMMANDS below, whenever the user requests a view change by manipulating the scrollbar.

  この指示項目は典型的には二つの要素のリスト､摺動可能な部品の名前に続く xview (水平摺動盤の場合)か yview (垂直摺動盤の場合)から構成される｡ 　　　　　　　　　 This option typically consists of a two-element list, containing the name of a scrollable widget followed by either xview (for horizontal scrollbars) or yview (for vertical scrollbars).

Command-Line Name: -orient
Database Name: orient
Database Class: Orient
  Orient horizontal か vertical かの内の一つ｡摺動盤の向きを指定する｡ 　　　　　 One of horizontal or vertical. Specifies the orientation of the scrollbar.

### 部品命令 WIDGET COMMAND

pathName cget option
  指定した option の現在の値を返す; ttk::widget(n) を参照されたい｡ 　　　　　　　　　 Returns the current value of the specified option; see ttk::widget(n).

pathName configure ?option? ?value option value ...?
  部品の指示項目を修正又は問合せする; ttk::widget(n) を参照されたい｡ 　　　　　　　　 Modify or query widget options; see ttk::widget(n).

pathName get
  摺動盤の設定をリストの形式にして返す､その要素は最も最近の set 部品命令の引数である｡ 　　　　　　 Returns the scrollbar settings in the form of a list whose elements are the arguments to the most recent set widget command.

pathName identify x y
  位置 x, y にある要素の名前を返す; ttk::widget(n) を参照されたい｡ 　　　　　　　　　　　 Returns the name of the element at position x, y. See ttk::widget(n).

pathName instate statespec ?script?
  部品の状態を試験する; ttk::widget(n) を参照されたい｡ 　　　　　　　 Test the widget state; see ttk::widget(n).

pathName set first last
  この命令は摺動盤に結合した部品によって -xscrollcommand か -yscrollcommand 回収から起動される｡部品内の現在の視野を摺動盤に伝える｡表示される可視領域を指定する｡ first と last は 0 と 1 の間の実数小数である｡ 　　　　　　　　　　　　 This command is normally invoked by the scrollbar's associated widget from an -xscrollcommand or -yscrollcommand callback. Specifies the visible range to be displayed. first and last are real fractions between 0 and 1.

pathName state ?stateSpec?
  部品の状態を修正又は問合せする; ttk::widget(n) を参照されたい｡ 　　　　　　　　 Modify or query the widget state; see ttk::widget(n).

### 内部命令 INTERNAL COMMANDS

次の部品命令は TScrollbar 部品級束縛によって内部的に使われている｡ 　　　　　　 The following widget commands are used internally by the TScrollbar widget class bindings.

pathName delta deltaX deltaY
  与えられた移動桿の位置の変更に相当する摺動盤内の設定の変更の割合を指し示す実数を返す｡譬えば､もし摺動盤が水平の場合､結果は移動桿を右に deltaX 画素移動する為に､摺動盤の設定が如何に多く必要かを指し示す(この場合 deltaY は無視される)｡もし摺動盤が垂直の場合､結果は移動桿を下に deltaY 画素移動する為に､摺動盤の設定が如何に多く必要かを指し示す｡引数と結果は零か負数でもよい｡ 　　　　　　 Returns a real number indicating the fractional change in the scrollbar setting that corresponds to a given change in thumb position. For example, if the scrollbar is horizontal, the result indicates how much the scrollbar setting must change to move the thumb deltaX pixels to the right (deltaY is ignored in this case). If the scrollbar is vertical, the result indicates how much the scrollbar setting must change to move the thumb deltaY pixels down. The arguments and the result may be zero or negative.

pathName fraction x y
  摺動盤の溝内の x と y で与えられた位置を指し示す 0 と 1 の間の実数を返す｡値 0 は溝の頂又は左に相当し､値 1 は底又は右に相当する｡ x と y は摺動部品に相対的な画素座標である｡もし x と y が溝の外の位置を参照すると溝内の最も近い位置が使われる｡ 　　　　　　　　　 Returns a real number between 0 and 1 indicating where the point given by x and y lies in the trough area of the scrollbar, where 0.0 corresponds to the top or left of the trough and 1.0 corresponds to the bottom or right. X and y are pixel coordinates relative to the scrollbar widget. If x and y refer to a point outside the trough, the closest point in the trough is used.

### SCROLLING COMMANDS

譬えば移動桿の曳摺りにより使用者が摺動盤に相互作用する時､摺動盤は結合した部品に視野の変更が必要である事を知らせる｡摺動盤は摺動盤の -command 指示項目により生成した Tcl 命令の評価により通知する｡その命令は次のどれかの形式をとる｡それぞれの場合 prefix は -command 指示項目の中身であり､通常 .t yview の様な形式を有する｡ 　　　　　　　　 When the user interacts with the scrollbar, for example by dragging the thumb, the scrollbar notifies the associated widget that it must change its view. The scrollbar makes the notification by evaluating a Tcl command generated from the scrollbar's -command option. The command may take any of the following forms. In each case, prefix is the contents of the -command option, which usually has a form like .t yview

prefix moveto fraction
  fraction は 0 と 1 の間の 実数である｡部品は部品の初めの位置から fraction で与えられた位置に表される様に視野を調整する｡もし fraction が 0 である場合､それは文章の初めを参照する｡ 1.0 は文章の末尾を参照し､ 0.333 は文章全体の三分の一の点を参照し､以下同様に続く｡ Fraction is a real number between 0 and 1. The widget should adjust its view so that the point given by fraction appears at the beginning of the widget. If fraction is 0 it refers to the beginning of the document. 1.0 refers to the end of the document, 0.333 refers to a point one-third of the way through the document, and so on.

prefix scroll number units
  部品は number の単位だけ視野を調整する｡単位は部品に対して､文書部品内での､文字､行等､どのような方法でもよい｡ number は1 か -1 で､ 1 では､１単位摺動され窓の上か左が外に外れ､ -1 では､１単位摺動され窓の底か右が外に外れる｡ 　　　　　　　　　　　　 The widget should adjust its view by number units. The units are defined in whatever way makes sense for the widget, such as characters or lines in a text widget. Number is either 1, which means one unit should scroll off the top or left of the window, or -1, which means that one unit should scroll off the bottom or right of the window.

prefix scroll number pages
  部品は number の頁だけ視野を調整する｡頁の意味の定義は部品による; 典型的には窓に嵌るより僅かに小さいので､旧視野と新視野は僅かに重複する｡ number は 1 か -1 で､ 1 では､次の頁が可視になり､ -1 では､前の頁が可視になる｡ 　　　　　　　　 The widget should adjust its view by number pages. It is up to the widget to define the meaning of a page; typically it is slightly less than what fits in the window, so that there is a slight overlap between the old and new views. Number is either 1, which means the next page should become visible, or -1, which means that the previous page should become visible.

### 部品状態WIDGET STATES

全ての範囲が可視( 0.0 から 1.0の範囲)の時は､摺動盤は自動的に disabled 状態印を設定する､それ以外では､印を解消する｡それは又マウス指示子の位置と状態に基いて､個別の要素の active と pressed 状態旗印を設定する｡ 　　　　　　 The scrollbar automatically sets the disabled state bit. when the entire range is visible (range is 0.0 to 1.0), and clears it otherwise. It also sets the active and pressed state flags of individual elements, based on the position and state of the mouse pointer.

### 用例 EXAMPLE

    set f [frame .f]
    ttk::scrollbar $f.hsb -orient horizontal -command [list $f.t xview]
    ttk::scrollbar $f.vsb -orient vertical -command [list $f.t yview]
    text $f.t -xscrollcommand [list $f.hsb set] -yscrollcommand [list $f.vsb set]
    grid $f.t -row 0 -column 0 -sticky nsew
    grid $f.vsb -row 0 -column 1 -sticky nsew
    grid $f.hsb -row 1 -column 0 -sticky nsew
    grid columnconfigure $f 0 -weight 1
    grid rowconfigure $f 0 -weight 1
    pack $f

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

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

Dynamic states: active, disabled.

ttk::style を使って構成設定可能な TScrollbar (更に特に Vertical.TScrollbar と Horizontal.TScrollbar) 様式指示項目は： TScrollbar (or more specifically Vertical.TScrollbar and Horizontal.TScrollbar) styling options that are configurable with ttk::style are:

-arrowcolor color
-arrowsize amount
-background color
-bordercolor color
-darkcolor color (color of the dark part of the 3D relief)
-foreground color
-gripcount count (number of lines on the thumb)
-lightcolor color (color of the light part of the 3D relief)
-troughcolor 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, scrollbar

### KEYWORDS

scrollbar, widget
Copyright © 1994-1996 Sun Microsystems, Inc.
Copyright © 2004 Joe English