次の方法で共有


Copy 関数

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

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

Description

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

注意

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

構文

コピー( テキスト )

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

使用例

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

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

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

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

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

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

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