wxPython in Action (ProgressDialog)

 9.1.5 如何显示进度条？

在许多程序中，程序需要自己做些事情而不受用户输入的干扰。这时就需要给用户一些可见的显示，以表明程序正在做一些事情及完成的进度。在wxPython中，这通常使用一个进度条来管理，如图9.5所示。

图9.5


例9.5显示了产生图9.5的代码

例9.5 生成一个进度条

import wx

if __name__ == "__main__":
    app = wx.PySimpleApp()
    progressMax = 100
    dialog = wx.ProgressDialog("A progress box", "Time remaining", progressMax,
            style=wx.PD_CAN_ABORT | wx.PD_ELAPSED_TIME | wx.PD_REMAINING_TIME)
    keepGoing = True
    count = 0
    while keepGoing and count < progressMax:
        count = count + 1
        wx.Sleep(1)
        keepGoing = dialog.Update(count)

    dialog.Destroy()
    
进度条的所有选项在构造函数中被设置，构造函数如下：

wx.ProgressDialog(title, message, maximum=100, parent=None, 
        style=wx.PD_AUTO_HIDE | wx.PD_APP_MODAL)

这些参数不同于其它对话框的。参数title被放置在窗口的标题栏，message被显示在对话框中。maximum是你用来显示进度计数的最大值。

表9.3 列出了特定于wx.ProgressDialog六个样式，它们影响进度条的行为。

表9.3 wx.ProgressDialog的样式

wx.PD_APP_MODAL：如果设置了这个样式，进度条对整个应用程序是模式的，这将阻塞所有的用户事件。如果没有设置这个样式，那么进度条仅对它的父窗口是模式的。

wx.PD_AUTO_HIDE：进度条将自动隐藏自身直到它达到它的最大值。

wx.PD_CAN_ABORT：在进度条上放上一个Cancel按钮，以便用户停止。如何响应来自该对话框的取消将在以后说明。

wx.PD_ELAPSED_TIME：显示该对话框已经出现了多长时间。

wx.PD_ESTIMATED_TIME：显示根据已花的时间、当前的计数值和计数器的最大值所估计出的完成进度所需的总时间。

wx.PD_REMAINING_TIME：显示要完成进度所估计的剩余时间，或(所需总时间-已花时间)。

要使用进度条，就要调用它的唯一的方法Update(value,newmsg="")。value参数是进度条的新的内部的值，调用update将导致进度条根据新的计数值与最大计算值的比例重绘。如果使用可选的参数newmsg，那么进度条上的文本消息将变为该字符串。这让你可以给用户一个关于当前进度的文本描述。

这个Update()方法通常返回True。但是，如果用户通过Cancel按钮已经取消了该对话框，那么下次的Update()将返回False。这是你响应用户的取消请求的机会。要检测用户的取消请求，我们建议你尽可能频繁地Update()。