wx.Timer 是 wxPython 提供的跨平台定時器,基於事件循環,在指定間隔發送 wx.EVT_TIMER 事件,**運行在主 UI 線程**,適合 UI 更新、狀態輪詢、動畫等任務。
import wx
import time
class TimerFrame(wx.Frame):
def __init__(self):
super().__init__(None, title="wx.Timer Demo", size=(400, 200))
panel = wx.Panel(self)
# UI 佈局
sizer = wx.BoxSizer(wx.VERTICAL)
self.btn_start = wx.Button(panel, label="Start Timer")
self.btn_stop = wx.Button(panel, label="Stop Timer")
self.status = wx.StaticText(panel, label="Waiting...")
sizer.Add(self.btn_start, 0, wx.ALL|wx.EXPAND, 10)
sizer.Add(self.btn_stop, 0, wx.ALL|wx.EXPAND, 10)
sizer.Add(self.status, 0, wx.ALL|wx.CENTER, 10)
panel.SetSizer(sizer)
# 創建定時器
self.timer = wx.Timer(self)
self.Bind(wx.EVT_TIMER, self.on_timer, self.timer)
# 綁定按鈕事件
self.btn_start.Bind(wx.EVT_BUTTON, self.on_start)
self.btn_stop.Bind(wx.EVT_BUTTON, self.on_stop)
self.Centre()
def on_start(self, event):
# 每 1000ms (1秒) 觸發一次
self.timer.Start(1000)
self.status.SetLabel("Timer running...")
def on_stop(self, event):
self.timer.Stop()
self.status.SetLabel("Timer stopped")
def on_timer(self, event):
# 定時器事件處理器 (運行在主線程)
now = time.strftime("%Y-%m-%d %H:%M:%S")
self.status.SetLabel(f"Current time: {now}")
if __name__ == '__main__':
app = wx.App()
frame = TimerFrame()
frame.Show()
app.MainLoop()
| 方法 | 說明 |
|---|---|
Timer(owner, id=-1) | 創建定時器,owner 接收事件 |
Start(milliseconds, oneShot=False) | 啟動,oneShot=True 單次觸發 |
Stop() | 停止定時器 |
IsRunning() | 檢查是否運行中 |
GetInterval() | 獲取間隔毫秒數 |
def delayed_action(self):
self.timer.Start(3000, oneShot=True) # 3秒後觸發一次
def on_timer(self, event):
if event.GetInterval() == 3000: # 識別單次定時器
self.do_something()
class MultiTimerFrame(wx.Frame):
def __init__(self):
super().__init__(None, title="Multi Timer")
self.timers = {}
# 定時器 1: 每秒更新時鐘
self.timers['clock'] = wx.Timer(self)
self.Bind(wx.EVT_TIMER, self.on_clock, self.timers['clock'])
# 定時器 2: 每5秒自動保存
self.timers['autosave'] = wx.Timer(self)
self.Bind(wx.EVT_TIMER, self.on_autosave, self.timers['autosave'])
self.timers['clock'].Start(1000)
self.timers['autosave'].Start(5000)
def on_clock(self, event):
self.SetStatusText(time.strftime("%H:%M:%S"))
def on_autosave(self, event):
self.save_document()
def cleanup(self):
for timer in self.timers.values():
timer.Stop()
# 基於事件循環的一次性延遲調用,不佔用定時器資源
wx.CallLater(500, self.callback, arg1, arg2, kwarg=value)
# 取消
call_later_obj = wx.CallLater(1000, self.long_task)
call_later_obj.Stop() # 尚未執行時取消
定時器運行在主線程,**不能**在工作線程直接操作 UI。正確模式:
import threading
import wx
class WorkerThread(threading.Thread):
def __init__(self, window):
super().__init__()
self.window = window
self.daemon = True
def run(self):
for i in range(10):
time.sleep(1)
# 線程安全發送事件到主線程
wx.CallAfter(self.window.update_progress, i * 10)
class MainFrame(wx.Frame):
def __init__(self):
super().__init__(None, title="Thread + Timer")
self.gauge = wx.Gauge(self, range=100)
self.btn = wx.Button(self, label="Start Work")
self.btn.Bind(wx.EVT_BUTTON, self.start_work)
sizer = wx.BoxSizer(wx.VERTICAL)
sizer.Add(self.gauge, 0, wx.ALL|wx.EXPAND, 10)
sizer.Add(self.btn, 0, wx.ALL|wx.CENTER, 10)
self.SetSizer(sizer)
def start_work(self, event):
self.btn.Disable()
WorkerThread(self).start()
def update_progress(self, value):
self.gauge.SetValue(value)
if value >= 100:
self.btn.Enable()
| 問題 | 原因 | 解決 |
|---|---|---|
| 定時器不觸發 | 未綁定 EVT_TIMER、owner 銷毀、主循環阻塞 | 檢查綁定、避免主線程長時間阻塞 |
| UI 卡頓 | 定時器回調執行耗時操作 | 耗時操作移至工作線程,wx.CallAfter 更新 UI |
| 內存洩漏 | Frame 銷毀前未 Stop() 定時器 | 在 __del__ 或 OnClose 中 Stop 所有定時器 |
| 單次定時器重複觸發 | oneShot=True 但邏輯錯誤 | 檢查 interval 或使用 CallLater |
wxasync 整合)善用 wx.Timer 與 wx.CallAfter/CallLater,能構建響應流暢、線程安全的 wxPython 桌面應用。