萬盛學電腦網

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

wxPython 剪貼簿操作完整指南:文字複製、貼上與資料物件模型

核心架構

wxPython 透過 wx.TheClipboard 單例存取系統剪貼簿,資料以 wx.DataObject 衍生類別封裝(TextDataObject、FileDataObject、BitmapDataObject、自訂格式)。

基本文字複製/貼上


import wx

class ClipboardDemo(wx.Frame):
    def __init__(self):
        super().__init__(None, title="剪貼簿示範", size=(400, 300))
        panel = wx.Panel(self)
        
        # UI 元件
        self.txt_input = wx.TextCtrl(panel, style=wx.TE_MULTILINE)
        btn_copy = wx.Button(panel, label="複製到剪貼簿")
        btn_paste = wx.Button(panel, label="從剪貼簿貼上")
        btn_flush = wx.Button(panel, label="複製並清空剪貼簿所有權")
        
        # 綁定事件
        btn_copy.Bind(wx.EVT_BUTTON, self.on_copy)
        btn_paste.Bind(wx.EVT_BUTTON, self.on_paste)
        btn_flush.Bind(wx.EVT_BUTTON, self.on_copy_flush)
        
        # 版面
        sizer = wx.BoxSizer(wx.VERTICAL)
        sizer.Add(wx.StaticText(panel, label="輸入文字:"), 0, wx.ALL, 5)
        sizer.Add(self.txt_input, 1, wx.EXPAND | wx.ALL, 5)
        for btn in (btn_copy, btn_paste, btn_flush):
            sizer.Add(btn, 0, wx.ALL | wx.CENTER, 5)
        panel.SetSizer(sizer)
        
        self.Centre()
        self.Show()

    def on_copy(self, event):
        """複製文字到剪貼簿"""
        text = self.txt_input.GetValue()
        if not text:
            wx.MessageBox("請先輸入文字", "提示", wx.ICON_INFORMATION)
            return
            
        data = wx.TextDataObject()
        data.SetText(text)
        
        if wx.TheClipboard.Open():
            wx.TheClipboard.SetData(data)
            wx.TheClipboard.Close()
            wx.MessageBox("已複製到剪貼簿", "成功", wx.ICON_INFORMATION)
        else:
            wx.MessageBox("無法開啟剪貼簿 (可能被其他程式佔用)", "錯誤", wx.ICON_ERROR)

    def on_paste(self, event):
        """從剪貼簿貼上文字"""
        data = wx.TextDataObject()
        
        if wx.TheClipboard.Open():
            success = wx.TheClipboard.GetData(data)
            wx.TheClipboard.Close()
            
            if success:
                self.txt_input.SetValue(data.GetText())
            else:
                wx.MessageBox("剪貼簿中無文字資料", "提示", wx.ICON_INFORMATION)
        else:
            wx.MessageBox("無法開啟剪貼簿", "錯誤", wx.ICON_ERROR)

    def on_copy_flush(self, event):
        """複製並釋放剪貼簿所有權 (Flush)"""
        text = self.txt_input.GetValue()
        if not text:
            return
            
        data = wx.TextDataObject()
        data.SetText(text)
        
        if wx.TheClipboard.Open():
            wx.TheClipboard.SetData(data)
            wx.TheClipboard.Flush()  # 關鍵:讓資料在應用程式關閉後仍保留在剪貼簿
            wx.TheClipboard.Close()
            wx.MessageBox("已複製並釋放所有權", "成功", wx.ICON_INFORMATION)
        else:
            wx.MessageBox("無法開啟剪貼簿", "錯誤", wx.ICON_ERROR)

if __name__ == "__main__":
    app = wx.App()
    ClipboardDemo()
    app.MainLoop()

關鍵方法對照

方法用途必要步驟
Open()取得剪貼簿鎖定必須成對呼叫 Close()
SetData(obj)放入資料物件需先 Open()
GetData(obj)取出資料 (布林回傳成功與否)需先 Open(),obj 需為正確型別
Flush()將資料寫入系統剪貼簿並釋放所有權應用程式退出前呼叫,否則資料隨程式結束消失
IsOpened()檢查是否已開啟避免重複 Open

進階:支援多種資料格式


class MultiFormatDataObject(wx.DataObjectComposite):
    """同時提供文字、HTML、RTF 等多種格式"""
    def __init__(self, text, html=None, rtf=None):
        super().__init__()
        self.Add(wx.TextDataObject(text), preferred=True)
        if html:
            self.Add(wx.HTMLDataObject(html))
        if rtf:
            self.Add(wx.RTFDataObject(rtf))

# 使用
data = MultiFormatDataObject(
    text="純文字版本",
    html="HTML 版本",
    rtf=r"{\rtf1 \b RTF 版本}"
)
wx.TheClipboard.SetData(data)

檔案拖放支援 (FileDataObject)


def copy_files_to_clipboard(file_paths):
    """將檔案清單放入剪貼簿,支援檔案總管貼上"""
    data = wx.FileDataObject()
    for path in file_paths:
        data.AddFile(os.path.abspath(path))
    
    if wx.TheClipboard.Open():
        wx.TheClipboard.SetData(data)
        wx.TheClipboard.Flush()
        wx.TheClipboard.Close()
        return True
    return False

常見問題與解決

  • 剪貼簿被佔用:Open() 失敗時重試幾次 (sleep 100ms),或提示使用者關閉其他程式
  • 大量文字效能:Windows 對剪貼簿大小有限制,超大文字建議存檔再用 FileDataObject
  • 跨平台差異:Linux (GTK) 下 Flush() 行為可能不同,測試時需注意
  • 執行緒安全:剪貼簿操作必須在主 GUI 執行緒,背景執行緒請用 wx.CallAfter 轉發

最佳實踐检查清單

  1. ✅ 所有 Open() 必配對 Close() (用 try/finally)
  2. ✅ 複製後呼叫 Flush() 確保資料持久
  3. ✅ 貼上前檢查 GetData() 回傳值
  4. ✅ 使用 DataObjectComposite 提供多格式相容性
  5. ✅ 異常處理包裹所有剪貼簿操作
copyright © 萬盛學電腦網 all rights reserved