Skip to content

剪贴板操作 ​

剪贴板读写工具函数。

读取 ​

get_clipboard_text() ​

获取剪贴板中的文本内容。

  • 返回 str | None

get_clipboard_file() ​

获取剪贴板中的文件路径。

  • 返回 str | None

get_clipboard(fmt) ​

获取指定格式的剪贴板数据。

  • fmt int — 剪贴板格式(如 CF_TEXT、CF_HDROP)
  • 返回 object

get_clipboard_all() ​

获取剪贴板中所有格式的数据。

  • 返回 Dict[int, object] — {format: data}

写入 ​

copy_text(text) ​

将文本复制到剪贴板。

  • text str — 要复制的文本

copy_files(file_paths) ​

将文件路径列表复制到剪贴板。

  • file_paths List[str] — 文件路径列表

set_clipboard(fmt, data) ​

设置指定格式的剪贴板数据。

  • fmt int — 剪贴板格式
  • data object — 数据

保存与恢复 ​

save_clipboard() ​

保存当前剪贴板内容(用于操作后恢复)。

  • 返回 Tuple[int, object] | None

restore_clipboard(saved) ​

恢复之前保存的剪贴板内容。

  • saved Tuple[int, object] | None — save_clipboard() 的返回值

辅助函数 ​

is_url(path) ​

判断路径是否为 URL。

  • 返回 bool

download_to_temp(url, timeout=60) ​

下载 URL 到临时文件。

  • 返回 str — 临时文件路径

示例 ​

python
from pywxauto.wx import (
    copy_text, get_clipboard_text,
    save_clipboard, restore_clipboard,
)

# 保存并恢复剪贴板
saved = save_clipboard()
copy_text("临时内容")
text = get_clipboard_text()
restore_clipboard(saved)  # 恢复原来的内容