Partager via


Copy Fonction

S’applique à : Applications Canvas

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

Description

La Copy fonction prend n’importe quelle 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 Copyfonction () est limitée à l’accès donné au Presse-papiers par l’hôte de l’application. Par conséquent, les scénarios d’applications incorporées tels que Power Apps dans SharePoint, les applications incorporé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( texte )

  • texte - Obligatoire. Texte à copier dans le Presse-papiers.

Examples

Entrée de texte avec Copy bouton

La Copy fonction peut être utilisée pour créer un style de contrôles d’entrée affiché dans de nombreuses applications, où un bouton pour le texte d’entrée permet une copie rapide du texte de l’entrée 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é CopyOnSelect du bouton sur ( 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 Copy fonction accepte le 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})" )