共用方式為


Copy 函數

適用於: 畫布應用

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

描述:

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

注意

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

語法

Copy正文

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

範例

使用按鈕輸入 Copy 文字

Copy 函數可用於創建許多應用程序中看到的輸入控件樣式,其中輸入文本的按鈕現在允許將輸入文本快速複製到剪貼板。

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

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

處理要放入剪貼簿的文字

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

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