原文地址http://download.oracle.com/javafx/2.0/ui_controls/progress.htm
ProgressIndicator及其直接子类
ProgressBar提供了指示特定任务正在运行并检测其完成进度的能力。
不过ProgressBar类用来显示一个显示进度完成的条,而
ProgressIndicator类则是将进度动态地显示在一个饼图里。见
Figure 16-1 .
Figure 16-1 Progress Bar and Progress Indicator
Description of "Figure 16-1 Progress Bar and Progress Indicator"
创建进度控件
Example 16-1 中的代码能够在JavaFX应用中插入一个进度控件。
Example 16-1 Implementing the Progress Bar and Progress Indicator
ProgressBar pb = new ProgressBar(0.6); ProgressIndicator pi = new ProgressIndicator(0.6);
也可以使用空构造方法创建进度控件而不指定参数。这时候,可以使用setProgress方法为它分配值。
另一个初始化进度控件的方法是使用
ProgressBarBuilder
类,该类包括诸如build和
progress
之类的方法。可以查看API文档去了解更多。
有时候应用并不能缺地in个任务的完成时间,这时进度控件就保持在非确定模式中直到可以确定。Figure 16-2 中是依赖于不同进度变量值的进度控件。
Figure 16-2 Various States of Progress Controls
Description of "Figure 16-2 Various States of Progress Controls"
Example 16-2 shows the source code of the application shown in Figure 16-2 .
Example 16-2 Enabling Different States of Progress Controls
import javafx.application.Application; import javafx.geometry.Pos; import javafx.scene.Group; import javafx.scene.Scene; import javafx.scene.control.Label; import javafx.scene.control.ProgressBar; import javafx.scene.control.ProgressIndicator; import javafx.scene.layout.HBox; import javafx.scene.layout.VBox; import javafx.stage.Stage; public class Main extends Application { final Float[] values = new Float[] {-1.0f, 0f, 0.6f, 1.0f}; final Label [] labels = new Label[values.length]; final ProgressBar[] pbs = new ProgressBar[values.length]; final ProgressIndicator[] pins = new ProgressIndicator[values.length]; final HBox hbs [] = new HBox [values.length]; @Override public void start(Stage stage) { Group root = new Group(); Scene scene = new Scene(root, 300, 150); scene.getStylesheets().add("progresssample/Style.css"); stage.setScene(scene); stage.setTitle("Progress Controls"); for (int i = 0; i < values.length; i++) { final Label label = labels[i] = new Label(); label.setText("progress:" + values[i]); final ProgressBar pb = pbs[i] = new ProgressBar(); pb.setProgress(values[i]); final ProgressIndicator pin = pins[i] = new ProgressIndicator(); pin.setProgress(values[i]); final HBox hb = hbs[i] = new HBox(); hb.setSpacing(5); hb.setAlignment(Pos.CENTER); hb.getChildren().addAll(label, pb, pin); } final VBox vb = new VBox(); vb.setSpacing(5); vb.getChildren().addAll(hbs); scene.setRoot(vb); stage.show(); } public static void main(String[] args) { launch(args); } }
一个在0和1之间的正数用来指示进程的百分比。 比如,0.4代表40%。而一个负数表示进度在非确定模式。用方法isIndeterminate
可以检查进度控件是否在非确定模式中。
在界面上指示进度
Figure 16-2 曾经简单的显示了进度控件的所以可能状态。实际应用中,进度值可以通过其他UI元素的值获得。
研究 Example 16-3 中的代码学习如何为基于滑标位置的进度条和指示器设置值。
Example 16-3 Receiving the Progress Value from a Slider
import javafx.application.Application; import javafx.beans.value.ChangeListener; import javafx.beans.value.ObservableValue; import javafx.geometry.Pos; import javafx.scene.Group; import javafx.scene.Scene; import javafx.scene.control.ProgressBar; import javafx.scene.control.ProgressIndicator; import javafx.scene.control.Slider; import javafx.scene.layout.HBox; import javafx.stage.Stage; public class Main extends Application { @Override public void start(Stage stage) { Group root = new Group(); Scene scene = new Scene(root); stage.setScene(scene); stage.setTitle("Progress Controls"); final Slider slider = new Slider(); slider.setMin(0); slider.setMax(50); final ProgressBar pb = new ProgressBar(0); final ProgressIndicator pi = new ProgressIndicator(0); slider.valueProperty().addListener(new ChangeListener<Number>() { public void changed(ObservableValue<? extends Number> ov, Number old_val, Number new_val) { pb.setProgress(new_val.doubleValue()/50); pi.setProgress(new_val.doubleValue()/50); } }); final HBox hb = new HBox(); hb.setSpacing(5); hb.setAlignment(Pos.CENTER); hb.getChildren().addAll(slider, pb, pi); scene.setRoot(hb); stage.show(); } public static void main(String[] args) { launch(args); } }
编译运行效果见 Figure 16-3 .
Figure 16-3 Indicating the Progress Set by a Slider
Description of "Figure 16-3 Indicating the Progress Set by a Slider"
一个 ChangeListener
对象决定了是否滑动条在动并计算进度条和指示器的值,所以进度控件值的范围是0.0到1.0.