Ruby/TK - 进度条控件

描述

一个ProgressBar 提供了一个小部件，它将显示一个值的图形化表示，给定最大和最小参考值。

语法

这是一个创建此小部件的简单语法：

Tk::ProgressBar.new(root) {
   .....Standard Options....
   .....Widget-specific Options....
}

标准选项

边框宽度
高亮厚度
水平填充
垂直填充
浮雕
槽颜色

这些选项已在上一章中进行了描述。

控件特定选项

序号	选项及描述
1	anchor => 字符串这可以用来定位条的起点。默认为 'w'（从左侧开始的水平条）。可以通过使用 's' 或 'n' 配置垂直条。
2	blocks => 整数这控制用于构建进度条的块数。默认为将条分成 10 个块。
3	colors => 字符串控制用于进度条不同位置的颜色。
4	from => 整数这设置了进度条的下限。如果将条设置为低于下限的值，则不会显示任何条。默认为 0。
5	gap => 整数这是每个块之间的间距（以像素为单位）。默认为 1。使用 0 获取连续条。
6	length => 整数指定 ProgressBar 的所需长尺寸（以屏幕单位为单位）。
7	resolution => 整数一个指定刻度分辨率的实数值。如果此值大于零，则刻度的值将始终四舍五入到此值的偶数倍数，刻度标记和刻度的端点也是如此。默认为 1。
8	to => 整数这设置了进度条的上限。如果指定了一个值（例如，使用 value 方法），该值高于此值，则将显示完整的进度条。默认为 100。
9	variable => 变量指定与 ProgressBar 链接的标量变量的引用。每当变量的值发生变化时，ProgressBar 都会更新以反映此值。
10	value => 整数这可以用来设置进度条的当前位置，当与标准 `configure` 结合使用时。通常建议使用 value 方法。
11	width => 整数指定 ProgressBar 的所需窄尺寸（以屏幕单位为单位）。

操作进度条

您可以使用 value(?value?) 方法以及 ProgressBar 实例来获取 ProgressBar 的当前值。如果给定值，则设置 ProgressBar 的值。

示例

require 'tk'
require 'tkextlib/bwidget'

root = TkRoot.new
root.title = "Window"

progressBar = Tk::BWidget::ProgressBar.new(root)

variable = TkVariable.new
progressBar.variable = variable

variable.value = 33

progressBar.maximum = 100
progressBar.place('height' => 25, 'width'  => 100, 'x'      => 10, 'y'      => 10)

Tk.mainloop

这将产生以下结果：

ruby_tk_guide.htm

打印页面

序号	选项及描述
1	anchor => 字符串这可以用来定位条的起点。默认为 'w'（从左侧开始的水平条）。可以通过使用 's' 或 'n' 配置垂直条。
2	blocks => 整数这控制用于构建进度条的块数。默认为将条分成 10 个块。
3	colors => 字符串控制用于进度条不同位置的颜色。
4	from => 整数这设置了进度条的下限。如果将条设置为低于下限的值，则不会显示任何条。默认为 0。
5	gap => 整数这是每个块之间的间距（以像素为单位）。默认为 1。使用 0 获取连续条。
6	length => 整数指定 ProgressBar 的所需长尺寸（以屏幕单位为单位）。
7	resolution => 整数一个指定刻度分辨率的实数值。如果此值大于零，则刻度的值将始终四舍五入到此值的偶数倍数，刻度标记和刻度的端点也是如此。默认为 1。
8	to => 整数这设置了进度条的上限。如果指定了一个值（例如，使用 value 方法），该值高于此值，则将显示完整的进度条。默认为 100。
9	variable => 变量指定与 ProgressBar 链接的标量变量的引用。每当变量的值发生变化时，ProgressBar 都会更新以反映此值。
10	value => 整数这可以用来设置进度条的当前位置，当与标准 `configure` 结合使用时。通常建议使用 value 方法。
11	width => 整数指定 ProgressBar 的所需窄尺寸（以屏幕单位为单位）。