Partager via

Fonction Copy

  • Article

S’applique à : Applications canevas Applications pilotées par modèle

Copie du texte dans le Presse-papiers de l’appareil où l’application est en cours d’exécution.

Description

La fonction Copy prend une valeur de texte et la copie dans le Presse-papiers. Quel que soit le contenu du texte, le Presse-papiers contiendra du texte brut sans aucun type mime spécial. La fonction est considérée comme une fonction à effets secondaires et, par conséquent, elle ne peut être utilisée que dans les propriétés de comportement.

Note

La fonction Copy() est limitée à l’accès fourni au Presse-papiers par l’hôte de l’application. En conséquence, les scénarios d’applications intégrées tels que Power Apps dans SharePoint, les applications intégrées dans Power BI, Teams, etc., ne prennent pas en charge Copy(). D’autres scénarios intégrés peuvent également ne pas prendre en charge la fonction. Les créateurs doivent utiliser IfError() pour garantir que l’action de copie dans le presse-papiers a été efficace et, dans le cas contraire, pour alerter correctement l’utilisateur de l’échec de la copie.

Syntaxe

Copy( text )

  • text : obligatoire. Texte à copier dans le Presse-papiers.

Examples

Saisie de texte avec le bouton Copier

La fonction Copy peut être utilisée pour créer un style de contrôles de saisie vus dans de nombreuses applications, où un bouton à côté du texte de saisie permet une copie rapide du texte de saisie dans le Presse-papiers.

  1. Insérez un contrôle Text input sur un écran. Par défaut, le nom sera TextInput1.
  2. Insérez un contrôle Button sur l’écran, à côté du contrôle de saisie.
  3. Définissez la propriété OnSelect du bouton sur Copy( TextInput1.Text ).

Lorsque le bouton est sélectionné, le texte du contrôle de saisie de texte sera copié dans le Presse-papiers.

Traitement du texte à insérer dans le Presse-papiers

La fonction Copy accepte du texte, qui peut être lui-même une expression qui manipule le texte de votre application d’une certaine manière. Par exemple, une application peut avoir un enregistrement d’employé contenant le prénom, nom, et le titre de l’employé. Une formule peut insérer ces informations dans le Presse-papiers en un seul bloc de texte. L’exemple suivant utilise l’interpolation de chaîne pour combiner les données en une seule chaîne :

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