跳到主要内容

写内容进剪贴板 (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