.TH ProgressBar 3tk "tcllib - BWidget"

.SH NAME
.B ProgressBar - 進度指示器元件

.SH 建立 CREATION
.B ProgressBar pathName ?option value...?

.SH 描述 DESCRIPTION
ProgressBar 元件向用戶指示一個冗長的操作的進度。它通常用於 MainFrame 和 ProgressDlg。

.SH 元件特有選項 WIDGET-SPECIFIC OPTIONS

.TP
-height  
為進度指示器指定想要的高度。 

.TP
-maximum  
指定變數的最大值。 

.TP
-type  
指定 ProgressBar 的型別。必須是 normal、incremental 或 infinite 之一。

如果 type 是 normal，則在每次設定變數的時候，按變數值和 maximum 選項來成比例的繪製進度指示器。 

如果 type 是 incremental，則在內部維護進度指示器的值，並在每次設定變數值的時候增加內部值。按內部值和 maximum 選項來成比例的繪製進度指示器。

如果 type 是 infinite， 則在內部維護進度指示器的值，並在每次設定變數值的時候增加內部值。 如果內部值(以 maximum 為模)小於 maximum/2 則進度指示器從左至右增長，並且如果內部值大於  maximum/2 則從右至左增長。 它的值的特殊情況請參見 -variable 選項。 

.TP
-variable 
指定聯絡(attach)到進度指示器上的變數。在這個變數的值變化的時候更新進度指示器。如果這個變數的值是負數，則不顯示進度指示器(用 background 色繪平(draw flat)它 - 用於 ProgressDlg 使它不可見)。如果它的值是 0，則重新初始化進度指示器。 

.TP
-width 
為進度指示器指定想要的寬度。

.SH 元件命令

.TP
pathName cget option  
返回用 option 給出的配置選項的當前值。Option 可以是能被建立命令接受的任何值。 

.TP
pathName configure ?option? ?value option value ...? 
查詢或修改這個元件的配置選項。如果未指定 option ，則返回描述 pathName 的所有可獲得的選項的一個列表。如果指定了不帶 value 的 option，則這個命令返回描述這個指名的 option 的一個列表(這個列表與未指定 option 所返回的值的相應的子集是一樣的)。如果指定了一個或多個選項-值 對，則這個命令把給定的元件選項修改為給定的值；在這種情況下這個命令返回一個空串。Option 可以是能被建立命令接受的任何值。只讀選項不可修改。

.SH "[中文版維護人]"
.B 寒蟬退士
.SH "[中文版最新更新]"
.B 2001/05/12
.SH "《中國 Linux 論壇 man 手冊頁翻譯計劃》:"
.BI http://cmpp.linuxforum.net
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR