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