wxPython其他功能的使用

### wxPython其他功能的使用 在使用wxPython进行开发时，除了之前常用的功能外，还有一些实用但无需单独成章介绍的特性，下面将详细介绍剪贴板操作、拖放操作等相关内容。 #### 1. 将对象放置到剪贴板 在wxPython中，剪贴板和拖放功能紧密相关，二者的窗口间通信都借助`wx.DataObject`或其子类的实例来实现。`wx.DataObject`是一种特殊的数据对象，包含描述数据输出格式的元数据。 ##### 1.1 剪贴板操作的基本元素 剪贴板操作主要包含三个元素： - **源（source）**：如果源在你的应用程序中，你的应用程序负责创建`wx.DataObject`的实例并将其传递给剪贴板对象。不过，剪贴板数据的源通常来自外部应用程序。 - **剪贴板（clipboard）**：这是一个全局对象，用于存储数据，并根据需要与底层系统剪贴板进行交互。 - **目标（target）**：负责从剪贴板中检索`wx.DataObject`，并将其转换为应用程序所需的有用数据。 ##### 1.2 向剪贴板中添加数据 若想让应用程序成为剪贴板事件的源，即能够将数据剪切或复制到剪贴板，需要将数据包装在`wx.DataObject`中。`wxPython`为常见用例提供了三个预定义的`wx.DataObject`子类： - **纯文本（plain text）**：使用`wx.TextDataObject`类。 ```python # 创建wx.TextDataObject实例 wx.TextDataObject(text="") ``` 创建对象时，可通过`text`参数指定要传递到剪贴板的文本。若创建时不知道文本内容，可使用`SetText(text)`方法设置文本，使用`GetText()`方法获取文本，使用`GetTextLength()`方法获取文本长度。 创建数据对象后，需要访问剪贴板。在`wxPython`中，系统剪贴板是一个全局对象，名为`wx.TheClipboard`。使用剪贴板时，需先使用`Open()`方法打开它，该方法返回布尔值`True`表示成功打开，`False`表示失败。若剪贴板正在被其他应用程序写入，打开操作可能会失败，因此在使用剪贴板前应检查返回值。使用完毕后，调用`Close()`方法关闭剪贴板，以避免阻塞其他剪贴板用户。 以下是向剪贴板添加文本的代码示例： ```python text_data = wx.TextDataObject("hi there") if wx.TheClipboard.Open(): wx.TheClipboard.SetData(text_data) wx.TheClipboard.Close() ``` ##### 1.3 操作剪贴板中的数据 打开剪贴板后，可以通过以下几种方式操作其中的数据： - **放置对象**：使用`SetData(data)`方法将数据对象放置到剪贴板，其中`data`为`wx.DataObject`的实例。 - **清空剪贴板**：使用`Clear()`方法清空剪贴板。 - **保留数据**：若希望应用程序关闭后剪贴板中的数据仍然保留，需调用`Flush()`方法，该方法会指示系统保留数据。否则，应用程序退出时，`wxPython`剪贴板对象将被清空。 ##### 1.4 从剪贴板中检索文本数据 从剪贴板中检索文本数据也较为简单。首先，需要检索并打开剪贴板，然后调用`GetData(data)`方法，其中`data`为`wx.DataObject`具体子类的实例。调用该方法时，`data`参数不应包含实际数据。该方法的返回值为布尔值，若剪贴板中的数据能够以与传入的数据对象兼容的格式输出，则返回`True`，否则返回`False`。 以下是从剪贴板检索文本数据的示例代码： ```python text_data = wx.TextDataObject() if wx.TheClipboard.Open(): success = wx.TheClipboard.GetData(text_data) wx.TheClipboard.Close() if success: return text_data.GetText() ``` 需要注意的是，从剪贴板检索数据时，无需关心数据是由哪个应用程序放置的。剪贴板中的数据由底层操作系统管理，`wxPython`的职责是确保格式在后台匹配，以保证你只能获取能够处理的数据格式。 ##### 1.5 剪贴板操作示例 下面是一个简单的示例，展示了如何向剪贴板传递数据以及从剪贴板获取数据。该示例是一个包含两个按钮的框架，允许用户复制和粘贴文本。 ```python import wx t1_text = """\ The whole contents of this control will be placed in the system's clipboard when you click the copy button below. """ t2_text = """\ If the clipboard contains a text data object then it will be placed in this control when you click the paste button below. Try copying to and pasting from other applications too! """ class MyFrame(wx.Frame): def __init__(self): wx.Frame.__init__(self, None, title="Clipboard", size=(500,300)) p = wx.Panel(self) self.t1 = wx.TextCtrl(p, -1, t1_text, style=wx.TE_MULTILINE|wx.HSCROLL) self.t2 = wx.TextCtrl(p, -1, t2_text, style=wx.TE_MULTILINE|wx.HSCROLL) copy = wx.Button(p, -1, "Copy") paste = wx.Button(p, -1, "Paste") fgs = wx.FlexGridSizer(2, 2, 5, 5) fgs.AddGrowableRow(0) fgs.AddGrowableCol(0) fgs.AddGrowableCol(1) fgs.Add(self.t1, 0, wx.EXPAND) fgs.Add(self.t2, 0, wx.EXPAND) fgs.Add(copy, 0, wx.EXPAND) fgs.Add(paste, 0, wx.EXPAND) border = wx.BoxSizer() border.Add(fgs, 1, wx.EXPAND|wx.ALL, 5) p.SetSizer(border) self.Bind(wx.EVT_BUTTON, self.OnDoCopy, copy) self.Bind(wx.EVT_BUTTON, self.OnDoPaste, paste) def OnDoCopy(self, evt): data = wx.TextDataObject() data.SetText(self.t1.GetValue()) if wx.TheClipboard.Open(): wx.TheClipboard.SetData(data) wx.TheClipboard.Close() else: wx.MessageBox("Unable to open the clipboard", "Error") def OnDoPaste(self, evt): success = False data = wx.TextDataObject() if wx.TheClipboard.Open(): success = wx.TheClipboard.GetData(data) wx.TheClipboard.Close() if success: self.t2.SetValue(data.GetText()) else: wx.MessageBox( "There is no data in the clipboard in the required format", "Error") app = wx.PySimpleApp() frm = MyFrame() frm.Show() app.MainLoop() ``` ##### 1.6 传递其他数据格式 除了纯文本，还可以通过剪贴板传递其他数据格式，如位图和文件名。 - **位图（bitmap）**：使用`wx.BitmapDataObject`类，其获取和设置方法分别为`GetBitmap()`和`SetBitmap(bitma