（翻译）第二十二回 JavaFX2.0 进度条和进度指示器

原文地址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.