Pygtk 简明教程

PyGTK - Clipboard Class

剪贴板对象在两个进程或同一应用程序的两个微件之间保存共享数据。gtk.Clipboard 为 gtk.SelectionData 类的上层接口。

以下是 gtk.Clipboard 构造函数的原型 −

gtk.Clipboard(display,selction)

其中,display 参数对应于 gtk.gdk.Display 对象,将基于该对象创建或检索剪贴板。默认情况下,它是标准输出设备。selection 参数默认为 CLIPBOARD,该对象表示已导入的字符串。

PyGTK 提供了一个便捷函数来创建具有默认值的剪贴板对象。

gtk.clipboard.get()

gtk.Clipboard 类具有以下方法 −

  1. Clipboard.store() − 这会将当前剪贴板数据存储在某处,以便即使在关闭应用程序之后也依然存在。

  2. Clipboard.clear() − 这会移除剪贴板中的内容。

  3. Clipboard.set_text(text) − 这可将剪贴板中的内容设置为字符串。

  4. Clipboard.request_text() − 这会请求剪贴板的内容并将其作为文本提供。在稍后收到文本时, callback 会使用 user_data 指定的数据进行调用。 callback 的签名为:def callback(clipboard, text, data) − text 将包含从剪贴板中检索到的 text

作为剪贴板演示,以下代码在顶级 gtk.Window 中使用了两个 TextView 和两个按钮。'Set' 按钮会调用 on_set() 函数,该函数会将第一个 textView 中的文本放入剪贴板中。

buf = self.tv1.get_buffer()
text = buf.get_text(buf.get_start_iter(), buf.get_end_iter())
self.clipboard = gtk.clipboard_get()
self.clipboard.set_text(text)
self.clipboard.store()

当按下第二个按钮(“检索”)后,将使用 request_text() 方法从剪贴板中获取数据 −

self.clipboard.request_text(self.readclipboard,        user_data = None)

user_data 的内容进入回调方法 readclipboard() ,后者在第二个文本视图上显示它。

def readclipboard(self, clipboard, text, data):
   buffer = gtk.TextBuffer()
   buffer.set_text(text)
   self.tv2.set_buffer(buffer)

Example

以下是剪贴板操作的全部代码 −

import gtk

class PyApp(gtk.Window):

   def __init__(self):
      super(PyApp, self).__init__()

	  self.set_title("Clipboard demo")
      self.set_size_request(300,200)
      self.set_position(gtk.WIN_POS_CENTER)

      vbox = gtk.VBox(False, 5)
      self.tv1 = gtk.TextView()

      vbox.add(self.tv1)
      self.tv2 = gtk.TextView()

      vbox.add(self.tv2)
      hbox = gtk.HBox(True, 3)

      Set = gtk.Button("set")
      Set.set_size_request(70, 30)

      retrieve = gtk.Button("retrieve")
      hbox.add(Set)
      hbox.add(retrieve)
      halign = gtk.Alignment(1, 0, 0, 0)
      halign.add(hbox)

      vbox.pack_start(halign, False, False, 3)
      self.add(vbox)
      Set.connect("clicked", self.on_set)
      retrieve.connect("clicked", self.on_retrieve)
      self.connect("destroy", gtk.main_quit)
      self.show_all()

   def on_set(self, widget):
      buf = self.tv1.get_buffer()
      text = buf.get_text(buf.get_start_iter(), buf.get_end_iter())
      self.clipboard = gtk.clipboard_get()
      self.clipboard.set_text(text)
      self.clipboard.store()

   def on_retrieve(self, widget):
      self.clipboard.request_text(self.readclipboard, user_data=None)

   def readclipboard(self, clipboard, text, data):
      buffer = gtk.TextBuffer()
      buffer.set_text(text)
      self.tv2.set_buffer(buffer)

PyApp()
gtk.main()

上述代码将生成以下输出 −

clipboard demo