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

进度跟踪状态已改变