写内容进剪贴板 (pasteboard.write)
声明
pasteboard.write(数据 [, 通用类型标识 ])
pasteboard.write(剪贴板项目 [, 选项 ])
pasteboard.write(剪贴板项目列表 [, 选项 ])
参数
-
数据
字符串型,需要写入到剪贴板的内容
表型,剪贴板项目,键为 通用类型标识,值为字符串型数据(自 20260428 版本起支持)
表型,剪贴板项目列表,每项均为剪贴板项目(自 20260428 版本起支持) -
通用类型标识
文本型,可选参数,Uniform Type Identifiers,默认 "public.utf8-plain-text" -
选项
表型,可选参数(自 20260428 版本起支持)
local_only布尔型,仅保存在本机,iOS 10 及以上支持
expiration_date数字型,Unix 时间戳,单位秒,iOS 10 及以上支持剪贴板项目结构
{
["public.utf8-plain-text"] = "普通文本",
["public.rtf"] = "RTF 数据",
["public.html"] = "HTML 数据",
["public.png"] = "PNG 二进制数据",
...
}
返回值
- 是否成功
布尔型,写入成功返回true,否则返回false
说明
写内容进系统剪贴板
关键词:写入剪贴板、写入剪切板、写入粘贴板
传入剪贴板项目或剪贴板项目列表时,会向同一个剪贴板项目写入多种格式表示。iOS 9 会忽略 选项 参数。
示例
pasteboard.write("hello") -- 将文本 "hello" 写入到剪贴板中
--
pasteboard.write(screen.image():png_data(), 'public.png') -- 将当前屏幕截图写入到剪贴板
--
pasteboard.write([[{\rtf1\ansi\deff0
{\fonttbl{\f0 Helvetica;}}
{\colortbl;\red255\green0\blue0;}
\f0\fs32 normal {\b bold} {\i italic} \cf1 red\cf0\par
\u20320?\u22909?
}]], "public.rtf") -- 将 RTF 富文本写入到剪贴板中
-- 20260428 以上版本支持向同一个剪贴板项目写入多种格式
pasteboard.write({
["public.utf8-plain-text"] = "normal bold italic red\n你好",
["public.rtf"] = [[{\rtf1\ansi\deff0
{\fonttbl{\f0 Helvetica;}}
{\colortbl;\red255\green0\blue0;}
\f0\fs32 normal {\b bold} {\i italic} \cf1 red\cf0\par
\u20320?\u22909?
}]],
["public.html"] = [[<p>normal <b>bold</b> <i>italic</i> <span style="color:red">red</span><br>你好</p>]],
}, {
local_only = true,
expiration_date = os.time() + 3600,
})
注:上述代码中使用了非本章函数 screen.image