De functie Copy

Van toepassing op: Canvas-apps Modelgestuurde apps

Kopieert tekst naar het klembord op het apparaat waarop de app wordt uitgevoerd.

Omschrijving

De functie Copy neemt elke tekstwaarde en kopieert deze naar het klembord. Ongeacht de inhoud van de tekst, zal het klembord platte tekst bevatten zonder een speciaal mime-type. De functie wordt beschouwd als een neveneffectfunctie en kan daarom alleen worden gebruikt in gedragseigenschappen.

Notitie

De functie Copy() is beperkt tot de toegang gegeven tot het klembord door de host van de app. Als gevolg hiervan ondersteunen scenario's voor ingebedde apps, zoals Power Apps in SharePoint, ingebedde apps in Power BI, Teams, etc. de optie Kopiëren() niet. Andere ingebedde scenario's ondersteunen de functie mogelijk ook niet. Makers zouden gebruik moeten maken van IfError() om ervoor te zorgen dat de actie om naar het klembord te kopiëren effectief was. Als dat niet het geval is, moet de gebruiker op de juiste manier gewaarschuwd worden dat het kopiëren is mislukt.

Syntaxis

Copy( tekst )

• tekst - vereist. De tekst die naar het klembord moet worden gekopieerd.

Voorbeelden

Tekstinvoer met kopieerknop

De functie Copy kan worden gebruikt om een stijl van invoerbesturingselementen te creëren die in veel apps te zien is, waarbij een knop direct naar de invoertekst een snelle kopie van de invoertekst mogelijk maakt naar het klembord.

1. Voeg een besturingselement Text input toe aan een scherm. Standaard is TextInput1 de naam.
2. Plaats een besturingselement Button op het scherm, naast het invoerbesturingselement.
3. Stel de eigenschap OnSelect van de knop in op Copy( TextInput1.Text ).

Wanneer de knop is geselecteerd, wordt de tekst van het tekstinvoerbesturingselement naar het klembord gekopieerd.

Tekst verwerken om op klembord te plaatsen

De Copy-functie accepteert tekst, wat zelf een expressie kan zijn die op de een of andere manier tekst uit uw app manipuleert. Een app kan bijvoorbeeld een werknemersrecord hebben dat de voornaam, achternaam en titel van de werknemer bevat. Een formule kan deze informatie als één stuk tekst op het klembord plaatsen. In het volgende voorbeeld wordt tekenreeksinterpolatie gebruikt om de gegevens tot één tekenreeks te combineren:

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