wxPython - Guage 类

• 

  简述

  wxPython中的进度条控件被称为Gauge. Wx.Gauge 类对象显示一个垂直或水平条，以图形方式显示递增数量。它通常用于演示复制文件或安装软件等过程的进展。

  Wx.Gauge control可用于确定模式和不确定模式。当可以相当准确地确定完成任何操作所需的时间时，仪表进度条会显示已完成任务的百分比。但是，在不确定模式下，它仅表示该过程正在进行中。

  在确定模式下，进度位置会定期更新。在不确定模式下，调用 Pulse() 函数将更新进度条。

  Wx.Gauge 类构造函数所需的参数是 -

  
  wx.Gauge(parent, id, range, pos, size, style)
  

  range 参数设置仪表的最大值。在不确定模式下，此参数被忽略。

  Gauge 类的可能样式参数是 -

  序列号	参数及说明
  1	wx.GA_HORIZONTAL 进度条的横向布局
  2	wx.GA_VERTICAL 进度条的垂直布局
  3	wx.GA_SMOOTH 使用一个像素宽的更新步骤平滑进度条
  4	wx.GA_TEXT 以百分比显示当前值

  下表列出了此类的一些重要方法 -

  序列号	方法和描述
  1	GetRange() 返回仪表的最大值
  2	SetRange() 设置仪表的最大值
  3	GetValue() 返回仪表的当前值
  4	SetValue() 以编程方式设置当前值
  5	Pulse() 将仪表切换到不确定模式

• 

  例子

  在以下示例中，在面板的垂直框尺寸器中添加了一个水平 Gauge 对象。

  
  self.gauge = wx.Gauge(pnl, range = 20, size = (250, 25), style = wx.GA_HORIZONTAL)
  

  还有一个按钮，其单击事件与处理函数相关联。

  
  self.btn1 = wx.Button(pnl, label = "Start") 
  self.Bind(wx.EVT_BUTTON, self.OnStart, self.btn1)
  

  处理函数 OnStart() 每秒钟更新一次仪表的进度。

  
  def OnStart(self, e): 
     while True: 
        time.sleep(1); 
        self.count = self.count + 1 
        self.gauge.SetValue(self.count) 
                  
        if self.count >= 20: 
           print "end" 
           return 
  

  该示例的完整代码如下 -

  
  import wx 
  import time 
  class Mywin(wx.Frame): 
              
     def __init__(self, parent, title): 
        super(Mywin, self).__init__(parent, title = title,size = (300,200))  
        self.InitUI() 
           
     def InitUI(self):    
        self.count = 0 
        pnl = wx.Panel(self) 
        vbox = wx.BoxSizer(wx.VERTICAL)
                  
        hbox1 = wx.BoxSizer(wx.HORIZONTAL) 
        hbox2 = wx.BoxSizer(wx.HORIZONTAL)
                  
        self.gauge = wx.Gauge(pnl, range = 20, size = (250, 25), style =  wx.GA_HORIZONTAL) 
        self.btn1 = wx.Button(pnl, label = "Start") 
        self.Bind(wx.EVT_BUTTON, self.OnStart, self.btn1) 
                  
        hbox1.Add(self.gauge, proportion = 1, flag = wx.ALIGN_CENTRE) 
        hbox2.Add(self.btn1, proportion = 1, flag = wx.RIGHT, border = 10) 
           
        vbox.Add((0, 30)) 
        vbox.Add(hbox1, flag = wx.ALIGN_CENTRE) 
        vbox.Add((0, 20)) 
        vbox.Add(hbox2, proportion = 1, flag = wx.ALIGN_CENTRE) 
        pnl.SetSizer(vbox) 
           
        self.SetSize((300, 200)) 
        self.Centre() 
        self.Show(True)   
                  
     def OnStart(self, e): 
        while True: 
           time.sleep(1); 
           self.count = self.count + 1 
           self.gauge.SetValue(self.count) 
                          
           if self.count >= 20: 
              print "end" 
              return 
                                  
  ex = wx.App() 
  Mywin(None,'wx.Gauge') 
  ex.MainLoop()
  

  上面的代码产生以下输出 -