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)
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),或提示使用者關閉其他程式FileDataObjectFlush() 行為可能不同,測試時需注意wx.CallAfter 轉發Open() 必配對 Close() (用 try/finally)Flush() 確保資料持久GetData() 回傳值DataObjectComposite 提供多格式相容性