剪贴板操作

剪贴板读写工具函数。

读取

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 — 临时文件路径

示例

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)  # 恢复原来的内容