Copy 関数

  • [アーティクル]

適用先: キャンバス アプリ モデル駆動型アプリ

アプリが実行されているデバイスのクリップボードにテキストをコピーします。

Description

Copy 関数は、任意のテキスト値を取得してクリップボードにコピーします。 テキストの内容に関係なく、クリップボードには特別な MIME タイプのないプレーン テキストが含まれます。 この関数は副作用関数と見なされるため、動作プロパティでのみ使用できます。

注意

Copy() 関数は、アプリのホストによって与えられたクリップボードへのアクセスに制限されています。 その結果、 Power Apps in SharePoint、組み込みアプリin Power BI などの組み込みアプリのシナリオは、 Copy() をサポートしません。 IfError() を使用して、クリップボードにコピーするアクションが有効であることを確認し、そうでない場合は、コピーが失敗したことをユーザーに適切に警告することをメーカーに推奨します。

構文

Copy( text )

  • text - 必須。 クリップボードにコピーするテキスト。

使用例

コピーボタンによる文字入力

Copy 機能を使用すると、多くのアプリで見られる入力コントロールのスタイルを作成できます。入力テキストへのボタンを使用すると、入力テキストをクリップボードにすばやくコピーできます。

  1. Text inputコントロールを画面に挿入します。 既定では、TextInput1 という名前になります。
  2. 画面上の入力コントロールの隣に Button コントロールを挿入します。
  3. ボタンの OnSelect プロパティを Copy( TextInput1.Text ) に設定します。

ボタンが選択されると、テキスト入力コントロールからのテキストがクリップボードにコピーされます。

テキストを処理してクリップボードに入れる

Copy 関数はテキストを受け取ります。これは、アプリからのテキストを何らかの方法で操作する式である可能性があります。 たとえば、アプリには、従業員の 名, 姓, と役職を含む従業員レコードがある場合があります。 式は、この情報を1つのテキストとしてクリップボードに入れることができます。 次の例では、文字列補間を使用して、データを 1 つの文字列に結合しています。

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