Copy 函式

適用於： 畫布應用程式 模型導向應用程式

在應用程式執行所在的裝置上將文字複製到剪貼簿。

描述:

Copy 函式接受任何文字值，並將其複製到剪貼簿。 不論文字的內容如何，剪貼簿都會包含沒有任何特殊 MIME 類型的純文字。 此函式視為副作用函式，並因此只能在行為屬性中使用。

注意

Copy() 函式受限於應用程式主機提供給剪貼簿的存取權。 因此，嵌入式應用方案 (例如 SharePoint 中的 Power Apps、Power BI、Teams 中的嵌入式應用程式等) 不支援 Copy()。 其他嵌入式場景也可能不支援該功能。 製作者應該使用 IfError() 確保複製到剪貼簿的操作有效，如果無效，則正確提醒使用者複製失敗。

語法

Copy( text )

• text - 必要。 要複製到剪貼簿的文字。

範例

含 [複製] 按鈕的文字輸入

Copy 函式可以用來建立許多應用程式中所見輸入控制項的樣式，其中輸入文字的按鈕現在允許將輸入的文字快速複製到剪貼簿。

1. 在畫面上插入 Text input 控制項。 名稱預設會是 TextInput1。
2. 在畫面中的輸入控制項旁邊插入 Button 控制項。
3. 將按鈕的 OnSelect 屬性設定為 Copy( TextInput1.Text )。

選取按鈕時，文字輸入控制項中的文字會複製到剪貼簿。

處理要放入剪貼簿的文字

Copy 函式接受文字，而此文字本身可以是以某種方式操作應用程式中文字的運算式。 例如，應用程式可能會有包含員工名字、姓氏和職稱的員工記錄。 公式可以將此資訊放入剪貼簿中做為一段文字。 下列範例使用字串插補，將資料合併成一個字串：

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