萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

wxPython 定時器 wx.Timer 完整指南:事件驅動定時任務實戰

wx.Timer 核心機制

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

關鍵 API 詳解

方法說明
Timer(owner, id=-1)創建定時器,owner 接收事件
Start(milliseconds, oneShot=False)啟動,oneShot=True 單次觸發
Stop()停止定時器
IsRunning()檢查是否運行中
GetInterval()獲取間隔毫秒數

進階模式

1. 單次定時器 (一次性延遲執行)


def delayed_action(self):
    self.timer.Start(3000, oneShot=True)  # 3秒後觸發一次

def on_timer(self, event):
    if event.GetInterval() == 3000:  # 識別單次定時器
        self.do_something()

2. 多定時器管理


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

3. 高精度/低延遲替代:wx.CallLater


# 基於事件循環的一次性延遲調用,不佔用定時器資源
wx.CallLater(500, self.callback, arg1, arg2, kwarg=value)

# 取消
call_later_obj = wx.CallLater(1000, self.long_task)
call_later_obj.Stop()  # 尚未執行時取消

線程安全:從工作線程觸發 UI 更新

定時器運行在主線程,**不能**在工作線程直接操作 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

定時器 vs 線程 vs asyncio 選型

  • wx.Timer:UI 週期性更新、簡單延遲、主線程安全操作
  • threading.Timer:後台非 UI 任務、需真並行
  • asyncio:高併發 I/O、協程調度 (需 wxasync 整合)

善用 wx.Timer 與 wx.CallAfter/CallLater,能構建響應流暢、線程安全的 wxPython 桌面應用。

copyright © 萬盛學電腦網 all rights reserved