通过

Copy 函数

  • 项目

适用于： 画布应用 模型驱动应用

将文本复制到运行应用的设备上的剪贴板中。

说明

Copy 函数获取任何文本值并将其复制到剪贴板。 无论文本内容如何，剪贴板都将包含没有任何特殊 Mime 类型的纯文本。 该函数被认为是副作用函数，因此它只能用于行为属性。

备注

Copy() 函数仅限于应用主机提供的剪贴板访问权限。 因此，嵌入式应用方案（如 Power Apps 中的 SharePoint、嵌入式应用中的 Power BI、Teams 等）不支持 Copy()。 其他嵌入式方案可能支持也可能不支持该函数。 制作者应使用 IfError()来确保复制到剪贴板的操作有效，如果无效，则适当提醒用户复制失败。

语法

副本（ 文本 ）

  • text - 必需。 要复制到剪贴板的文本。

示例

带“复制”按钮的文本输入

Copy 函数可用于创建在许多应用中看到的输入控件样式，其中，输入文本按钮现在允许将输入文本快速复制到剪贴板。

  1. 在屏幕上插入 Text input 控件。 默认情况下，名称将为 TextInput1。
  2. 在屏幕上的输入控件旁边插入一个 Button 控件。
  3. 将该按钮的 OnSelect 属性设置为 Copy( TextInput1.Text )。

选择该按钮时，文本输入控件中的文本将被复制到剪贴板。

处理文本以放入剪贴板

Copy 函数接受文本，文本本身可以是一个以某种方式操作应用中的文本的表达式。 例如，应用可能有一条员工记录，此记录包含员工的名字、姓氏和职务。 公式可以将此信息作为一段文本放在剪贴板上。 以下示例使用字符串内插将数据合并为一个字符串：

Copy( $"{employeeRecord.Name} {employeeRecord.LastName} ({employeeRecord.Title})" )