Skip to content

Latest commit

 

History

History
66 lines (40 loc) · 2.05 KB

clipboard.rst

File metadata and controls

66 lines (40 loc) · 2.05 KB

剪贴板

Gtk.Clipboard 为各种数据提供了一个存储区域,包括文本和图像。使用剪贴板 允许这些数据在不同的程序间通过复制、剪切、粘贴等动作共享。这些动作通常通过三种 方式完成:使用键盘快捷键、使用 Gtk.MenuItem ,将这些动作的函数与 Gtk.Button 控件连接。

对于不同的目的有多种的剪贴板,在觉到多数环境下, ClIPBOARD 用于日常的复制和 粘贴, PRIMARY 则存储光标选中的文本。

Clipboard 对象

get(selection)

根据 selection 获得相应的 Gtk.Clipboard

selection 为描述使用哪一个剪贴板的 Gdk.Atom 的实例。 预定义的值:

  • Gdk.SELECTION_CLIPBOARD
  • Gdk.SELECTION_PRIMARY

set_text(text, length)

设置剪贴板的内容为给的的文本。

text 是要放进剪贴板的字符串。

length 是要存放的字符数。如果存储整个字符串则可以忽略。

set_image(image)

设置剪贴板的内容为给定的图像。

image 必须为 Gdk.Pixbuf 的实例。 要从 Gdk.Image 获取,使用 image.get_pixbuf()

wait_for_text()

以字符串返回剪贴板的内容,如果剪贴板为空或者当前没有文本则返回 None

wait_for_image()

Gtk.Pixbuf 返回接铁板的内容。 如果剪贴板内没有图像或为空则返回 None

store()

在本程序之外保存剪贴板的内容,否则拷贝到剪贴板中的数据可能会在程序退出时会消失。

clear()

清除剪贴板的内容。 使用请注意,可能会清除其他程序设置的内容。

Example

image

examples/clipboard_example.py