Funktion „Copy“
Gilt für:
Canvas-Apps Modellgesteuerte Apps
Kopiert Text in die Zwischenablage auf dem Gerät, auf dem die App ausgeführt wird.
Beschreibung
Die Funktion Copy nimmt 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 Funktion Copy() ist auf den Zugriff beschränkt, der vom Host der App auf die Zwischenablage gewährt wird. Als Ergebnis können eingebettete Anwendungsszenarien wie Power Apps in SharePoint, eingebettete Apps in Power BI, Teams usw. unterstützen nicht Kopieren(). 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
Kopieren( Text )
- Text – Erforderlich. Der Text in der Zwischenablage zu kopierende text.
Beispiele
Texteingabe mit Copy-Schaltfläche
Die Funktion Copy kann verwendet werden, um einen Stil von Eingabesteuerelementen zu erstellen, der in vielen Apps zu sehen ist, wobei eine Schaltfläche direkt neben dem Eingabetext eine schnelle Kopie des Eingabetexts in die Zwischenablage ermöglicht.
- Fügen Sie ein Text input-Steuerelement in einem Bildschirm ein. Standardmäßig lautet der Name TextInput1.
- Fügen Sie ein Button-Steuerelement neben dem input-Steuerelement auf dem Bildschirm ein.
- 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 Funktion Copy akzeptiert Text, der selbst ein Ausdruck sein kann, mit dem Text aus Ihrer App auf irgendeine Weise manipuliert wird. 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})" )