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

進度跟蹤狀態已改變