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

### 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::progressbar — 経過饋還を提供する　　　Provide progress feedback
  構文 SYNOPSIS
  説明 DESCRIPTION
  STANDARD OPTIONS
    -anchor, anchor, Anchor
    -class, undefined, undefined
    -cursor, cursor, Cursor
    -font, font, Font
    -foreground, textColor, TextColor
    -justify, justify, Justify
    -style, style, Style
    -takefocus, takeFocus, TakeFocus
    -text, text, Text
    -wraplength, wrapLength, WrapLength
  WIDGET-SPECIFIC OPTIONS
    -length, length, Length
    -maximum, maximum, Maximum
    -mode, mode, Mode
    -orient, orient, Orient
    -phase, phase, Phase
    -value, value, Value
    -variable, variable, Variable
  WIDGET COMMAND
    pathName start ?interval?
    pathName step ?amount?
    pathName stop
  様式の指示項目STYLING OPTIONS
  SEE ALSO

### NAME

ttk::progressbar — 経過饋還を提供する　　　Provide progress feedback

### 構文 SYNOPSIS

ttk::progressbar pathName ?options?

### 説明 DESCRIPTION

ttk::progressbar 部品は長期実行操作の状態を示す｡それは二つの様式で操作できる: determinate 様式は実行すべき仕事の総量に対する相対的完成の量を示す､ indeterminate 様式は何かが起っている旨､使用者に知らせる動画的表示を提供する｡　　　　　 A ttk::progressbar widget shows the status of a long-running operation. They can operate in two modes: determinate mode shows the amount completed relative to the total amount of work to be done, and indeterminate mode provides an animated display to let the user know that something is happening.

-orient の値が水平の horizontal 場合､文書文字列は経過帯の内側に表示され得る｡この文字列は -anchor, -font, -foreground, -justify, -text and -wraplength 指示項目を使って構成設定できる｡もし -orient の値が垂直の vertical の場合これらの指示項目は無視される｡ If the value of -orient is horizontal a text string can be displayed inside the progressbar. This string can be configured using the -anchor, -font, -foreground, -justify, -text and -wraplength options. If the value of -orient is vertical then these options are ignored.

### STANDARD OPTIONS

-anchor, anchor, Anchor
-class, undefined, undefined
-cursor, cursor, Cursor
-font, font, Font
-foreground, textColor, TextColor
-justify, justify, Justify
-style, style, Style
-takefocus, takeFocus, TakeFocus
-text, text, Text
-wraplength, wrapLength, WrapLength

### WIDGET-SPECIFIC OPTIONS

Command-Line Name: -length
Database Name: length
Database Class: Length
  経過帯の長い軸の長さを指定する(水平では幅､垂直では高さ)｡値は Tk_GetPixels に受容れられるどの形式でも好い｡ Specifies the length of the long axis of the progress bar (width if horizontal, height if vertical). The value may have any of the forms acceptable to Tk_GetPixels.

Command-Line Name: -maximum
Database Name: maximum
Database Class: Maximum
  -value の最大値を定める浮動小数｡省略時設定は100. ｡　　　　　 A floating point number specifying the maximum -value. Defaults to 100.

Command-Line Name: -mode
Database Name: mode
Database Class: Mode
  相対値の determinate か テキトーの indeterminate のどちらか｡　　　　　 One of determinate or indeterminate.

Command-Line Name: -orient
Database Name: orient
Database Class: Orient
  水平のhorizontal か垂直のvertical のどちらか｡経過帯の方向を指定する｡　　　　 One of horizontal or vertical. Specifies the orientation of the progress bar.

Command-Line Name: -phase
Database Name: phase
Database Class: Phase
  読出し専用指示項目｡何時であれ -value が 0 より大きく､且つ､ determinate 様式内では -maximum より小さい時は､この指示項目の値が定期的に増加される｡この指示項目は現在の主題を追加的な動画の効果に提供する為にも使用される｡　　　　　　　　　 Read-only option. The widget periodically increments the value of this option whenever the -value is greater than 0 and, in determinate mode, less than -maximum. This option may be used by the current theme to provide additional animation effects.

Command-Line Name: -value
Database Name: value
Database Class: Value
  経過帯の現在の値｡ determinate 様式内ではこれは完了した仕事の量を表す｡ indeterminate 様式内では -maximum の剰余を表示する; 即ち､ -value が -maximum に増加した時､経過帯は､一回の “周期” を完了する｡もし､ -variable が実在の変数に設定されると､指定 -value は効果を持たない(変数値は優先権を取る)｡ The current value of the progress bar. In determinate mode, this represents the amount of work completed. In indeterminate mode, it is interpreted modulo -maximum; that is, the progress bar completes one “cycle” when the -value increases by -maximum. If -variable is set to an existing variable, specifying -value has no effect (the variable value takes precedence).

Command-Line Name: -variable
Database Name: variable
Database Class: Variable
  -value に連結する大域 Tcl 変数の名前｡もし実在の変数に指定されると､この経過帯の -value は､何時であれ値が修正されると自動的に変数に設定される｡　　 The name of a global Tcl variable which is linked to the -value. If specified to an existing variable, the -value of the progress bar is automatically set to the value of the variable whenever the latter is modified.

### WIDGET COMMAND

標準の､ cgetと configureと identify elementと instateと state と style 命令(ttk::widget参照)に加え､ 経過棒部品は次の追加命令にも対応する: In addition to the standard cget, configure, identify element, instate, state and style commands (see ttk::widget), progressbar widgets support the following additional commands:

pathName start ?interval?
  自動増加様式を開始する: 千分の一秒の interval 倍毎に step を呼ぶ繰返し時間を予定する｡もし省略されると､ interval は省略時設定の 50 厘秒(20 回/秒)になる｡ 　　　　　　　 Begin autoincrement mode: schedules a recurring timer event that calls step every interval milliseconds. If omitted, interval defaults to 50 milliseconds (20 steps/second).

pathName step ?amount?
  -value を amount だけ増加する｡ amount の省略時設定は 1.0 ｡ 　　　　　 Increments the -value by amount. amount defaults to 1.0 if omitted.

pathName stop
  自動増加様式を停止する: pathName start によって開始されたどの時間の繰返し行事も取消される｡　　　　　　　 Stop autoincrement mode: cancels any recurring timer event initiated by pathName start.

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

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

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

-background color
-bordercolor color
-darkcolor color
-lightcolor color
-maxphase

  For the aqua theme.

-period

  aqua 主題用 (Mac OS X)　　　　　 For the aqua theme.

-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
Copyright © 2005 Joe English