wxPython - Guage 类

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

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

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

Wx.Gauge类构造器需要的参数是 −

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

范围参数设置仪表的最大值。 在不确定模式下,该参数被忽略。

Gauge 类可能的 style 样式参数是 −

S.N. 参数 & 说明
1

wx.GA_HORIZONTAL

进度条横向布局

2

wx.GA_VERTICAL

进度条的垂直布局

3

wx.GA_SMOOTH

用一个像素宽的更新步骤平滑进度条

4

wx.GA_TEXT

以百分比显示当前值

下表列出了该类的一些重要方法 −

S.N. 方法与说明
1

GetRange()

返回仪表的最大值

2

SetRange()

设置仪表的最大值

3

GetValue()

返回仪表的当前值

4

SetValue()

以编程方式设置当前值

5

Pulse()

将仪表切换到不确定模式


示例

在下面的例子中,一个水平的Gauge对象被添加到面板的垂直的box sizer中。

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()

以上代码产生如下输出 −

Gauge 输出

❮ wxPython 主要类