怎么正确的使用SWT进度条

怎么正确的使用SWT进度条

摘要
使用进度条监视器并不像看起来的那么简单,在使用时很容易犯错。这取决于各种因素,像底层实现,显示方式,是否被设定固定数目的工作条目,是否使用了 SubProgressMonitor 嵌套,等等。结果可能是完全没问题,也可能是 让人挠头,或者彻底不可用。

本文将指导怎样有效的使用进度条监视器。

使用进度条监视器

在许多简单的惯例中,有一条是“只知道所知道的,并且仅限于此”。这就是说,不能假设完全了解你所不知道的事情。就像,你不能想当然的认为进度条监视器就是你在IDE中看到的那些图片样子的东西。

IProgressMonitor

通常,所有的进度条操作都是通过 IProgressMonitor接口.进度条监视器具有4中状态,通过接口只可以测到一种状态(当监视器被取消时)。状态的改变是通过如下方法的作用: beginTask(), done() and setCanceled().
  • PRISTINE
    IProgressMonitor实例被初始化之后,方法beginTask() 被调用之前的状态。
  • IN_USE
    方法beginTask()被调用之后的状态,这里要注意 beginTask()只能被调用一次,
  • FINISHED
    done()被调用之后的状态, 它也只能调用一次,并且只能在 beginTask()之后调用。
  • CANCELED
    进度条被取消之后的状态。

要以以下的模式使用进度条:
monitor = ?  		// 获取进度条实例,现在处于 pristine 状态
try
{
monitor.beginTask(?
// 执行工作任务
}
finally
{
monitor.done()
}
The 一定到保证 done() 最后被执行。

子任务用代理使用进度条监视器

beginTask()被调用不要多于一次,这种错误经常发生。进度条被传给子任务,子任务没有意识到进度条已经执行了 beginTask(),还是按照规定的契约,执行 beginTask()方法。除非子任务对此了解,否则传递进度条实例是十分错误的。一般情况下,接受到进度条实例的代码应该假设此实例自己会遵守 beginTask()/ done()契约。如果子任务也需要进度条,就应该使用 SubProgressMonitor作为代理,封装传入的进度条实例。

如下为样例:
monitor = ?// 获取进度条实例

try
{
monitor.beginTask(?
// 执行任务
?BR> // 创建一个子任务
someThing.doWork(new SubProgressMonitor(monitor,?)
// // 创建右一个子任务
anotherThing.doWork(new SubProgressMonitor(monitor,?)
}
finally
{
monitor.done()
}
每一个 doWork()调用得到一个新的 SubProgressMonitor 实例。

管理条目个数

如果确实不知道确切的条目总数,不要随意猜测数字。如果猜大了,数字会走的很慢,然后突然到达100%;如果猜小了,那么会很快到达终点,并且永远停在那里。没有确切总数的话,填写 IProgressMonitor.UNKNOWN就可以了。

怎样调用 beginTask()worked()

通常你可以通过两种方式得出你究竟要处理多少条目:一是调用许多不同的方法来得到结果,二是在一个集合中为每一个实例调用同一个方法。每种方式你都可以知道总的条目数(方法的个数或集合的大小)。

你应该将按比例测量出你的总数。如果总数是3 (每个条目工作为 worked(1)),你可以把比例定为1000,总数为3000, (每个条目工作为 worked(1000) ). 当你要通过SubProgressMonitor将工作传递到子任务中,就要应用这种方式。因为子任务内部的总数和外部是不同的,也许比你定的总数大许多。你要给它们一些缓冲润滑的空间。这样可以避免进度条执行时视觉上的便扭。

样例:
monitor = ?	// 取到进度条监视器
int total = 3 // 总数为3
try
{
monitor.beginTask(total)

// 条目1
this.doPart1()
monitor.worked(1)

// 条目 2
this.doPart2()
monitor.worked(1)

// 条目 3
this.doPart3()
monitor.worked(1)
}
finally
{
monitor.done()
}
这里没有必要按比例放大,也没有集合动态计算。

更详细的样例:
monitor = ?		
int total = thingyList.size() * 3 + 2
try
{
monitor.beginTask(total)

// 条目 1
this.doBeforeAllThingies()
monitor.worked(1)

// 条目 2 to 倒数第二个
for (Thingy t : thingyList)
{
t.doThisFirst()
monitor.worked(1)
t.thenDoThat()
monitor.worked(1)
t.lastlyDoThis()
monitor.worked(1)
}

// 最后一条
this.doAfterAllThingies()
monitor.worked(1)
}
finally
{
monitor.done()
}

混合使用子任务

在使用子任务的时候,子任务的总数就是分配给它的比例数。
monitor = ?	
int scale = 1000
int total = 3
try
{
monitor.beginTask(total * scale)

// item 1
this.doPart1()
monitor.worked(1 * scale)

// item 2
this.doPart2(new SubProgressMonitor(monitor, 1 * scale)) //分配一个条目
monitor.worked(1 * scale) // 这里是不需要的,因为任务的管理有子任务负责

// 条目 3
this.doPart3()
monitor.worked(1 * scale)
}
finally
{
monitor.done()
}
You worked().
Tip 不要将 IProgressMonitor.UNKNOWN 传给创建的 SubProgressMonitor()
子任务进度条的实现只是盲目的使用传入的总数进行计算,当它接受到的是一个负值( IProgressMonitor.UNKNOWN为-1) 它也是按照惯例来进行计算,所以你看到的结果是进度条往回走。 IProgressMonitor.UNKNOWN不能在子任务进度条中使用,但是在父进度条中使用没有这种问题。

取消

上面的例子中,都没有判断进度条是否被取消。在实际使用中,推荐要及时的进行判断。
monitor = ?	
try
{
monitor.beginTask(thingyList.size())

for (Thingy t : thingyList)
{
if(monitor.isCanceled())
throw new OperationCanceledException();
t.doSomething()
monitor.worked(1)
}
}
finally
{
monitor.done()
}

The 空进度条

这样可以使调用者不用必须传入monitor,只要输入null 就可以了。
public void doIt(IProgressMonitor monitor)
{

if(monitor == null)
monitor = new NullProgressMonitor();

try
{
monitor.beginTask(thingyList.size())

for (Thingy t : thingyList)
{
if(monitor.isCanceled())
throw new OperationCanceledException();
t.doSomething()
monitor.worked(1)
}
}
finally
{
monitor.done()
}
}

结论

只要遵循这些规则,在使用进度条的时候就不会碰到麻烦。如果不信邪,想当然的用,迟早会出现奇怪的视觉显示,你的客户又要不停的抱怨了。



评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值