Freigeben über


Copy-Funktion

Gilt für: Canvas-Apps

Kopiert Text in die Zwischenablage auf dem Gerät, auf dem die App ausgeführt wird.

Beschreibung

Die Copy Funktion akzeptiert einen beliebigen Textwert und kopiert ihn in die Zwischenablage. Unabhängig vom Inhalt des Textes enthält die Zwischenablage reinen Text ohne speziellen MIME-Typ. Die Funktion wird als Nebenwirkungsfunktion betrachtet und kann daher nur in Verhaltenseigenschaften verwendet werden.

Anmerkung

Die Copy() Funktion ist auf den Zugriff auf die Zwischenablage durch den Host der App beschränkt. Daher werden eingebettete Apps wie Power Apps in SharePoint, eingebettete Apps in Power BI, Teams usw. nicht unterstützt Copy(). Andere eingebettete Szenarien unterstützen die Funktion möglicherweise auch nicht. Hersteller sollten IfError() verwenden, um sicherzustellen, dass die Aktion zum Kopieren in die Zwischenablage wirksam war, und, falls dies nicht der Fall ist, den Benutzer entsprechend darauf hinzuweisen, dass der Kopiervorgang fehlgeschlagen ist.

Syntax

Copy( Text )

  • Text – Erforderlich. Der Text in der Zwischenablage zu kopierende text.

Beispiele

Texteingabe mit Copy Schaltfläche

Die Copy Funktion kann verwendet werden, um eine Formatvorlage für Eingabesteuerelemente zu erstellen, die in vielen Apps zu sehen sind, wobei eine Schaltfläche direkt zum Eingabetext eine schnelle Kopie des Eingabetexts in die Zwischenablage ermöglicht.

  1. Fügen Sie ein Text input-Steuerelement in einem Bildschirm ein. Standardmäßig lautet der Name TextInput1.
  2. Fügen Sie ein Button-Steuerelement neben dem input-Steuerelement auf dem Bildschirm ein.
  3. Legen Sie die OnSelect-Eigenschaft der Schaltfläche auf Copy( TextInput1.Text ) fest.

Wenn die Schaltfläche ausgewählt wird, wird der Text aus dem text input-Steuerelement in die Zwischenablage kopiert.

Verarbeiten von Text zum Ablegen in die Zwischenablage

Die Copy Funktion akzeptiert Text, der selbst ein Ausdruck sein kann, der Text aus Ihrer App auf irgendeine Weise bearbeitet. Beispielsweise kann eine App einen Mitarbeiterdatensatz haben, der den Vornamen, den Nachnamen und den Titel des Mitarbeiters enthält. Eine Formel könnte diese Informationen als den Teil eines Textes in die Zwischenablage legen. Im folgenden Beispiel wird die Zeichenfolgeninterpolation verwendet, um die Daten zu einer Zeichenfolge zu kombinieren:

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