ProgressView

ProgressView 是一個基礎實作，提供繪製進度資訊的功能。繼承自 BoxView。

ProgressView 使用以下描述的概念繪製其內容

  • ProgressState 包含關於執行時狀態的各種資訊

    • tickStart 刻度值的下限

    • tickEnd 刻度值的上限

    • tickValue 目前刻度值

    • running 執行狀態，true 或 false

    • startTime 進度開始時的毫秒級開始時間

    • updateTime 最後一次已知進度更新的毫秒級時間

  • ProgressContext 是與 ProgressViewItem 一起使用的上下文

    • description 給予進度的描述

    • state ProgressState

    • view 擁有的 ProgressView

    • spinner 與 ProgressView 一起使用的 Spinner 表示

    • 其他有助於項目繪製的方法

  • ProgressViewItem 是 ProgressView 中使用的儲存格表示

有幾個內建項目，即 text、spinner 和 percent。

預設的 ProgressView 提供 text、spinner 和 percent。

ProgressView view = new ProgressView();
view.start();

看起來像這樣

自訂

以下是一些關於各種自訂的範例

ProgressView view = new ProgressView(
	ProgressViewItem.ofText(10, HorizontalAlign.LEFT),
	ProgressViewItem.ofSpinner(3, HorizontalAlign.LEFT),
	ProgressViewItem.ofPercent(0, HorizontalAlign.RIGHT));
view.start();

將 text 和 spinner 對齊到左側，並給予它們較少的空間。將 percent 對齊到右側，並給予其剩餘空間。

預設繫結

沒有任何預設繫結。

事件

事件會根據進度的狀態發送。

表 1. ProgressView 事件
事件 描述

ProgressViewStartEvent

進度追蹤已開始

ProgressViewEndEvent

進度追蹤已停止

ProgressViewStateChangeEvent

進度追蹤狀態已變更