Función Copy

Se aplica a: Aplicaciones de lienzo Aplicaciones basadas en modelos

Copia texto al portapapeles en el dispositivo donde se ejecuta la aplicación.

Description

La función Copy toma cualquier valor de texto y lo copia en el portapapeles. Independientemente del contenido del texto, el portapapeles contendrá texto sin formato sin ningún tipo de mímica especial. La función se considera una función de efectos secundarios y, como resultado, solo se puede usar en propiedades de comportamiento.

Nota

La función Copy() está limitada al acceso otorgado al portapapeles por el anfitrión de la aplicación. Como resultado, los escenarios de aplicaciones integradas como Power Apps en SharePoint, aplicaciones integradas en Power BI, Teams, etc. no admiten Copy(). Es posible que otros escenarios integrados tampoco admitan la función. Los fabricantes deben utilizar IfError() para garantizar que la acción de copiar al portapapeles fuera efectiva y, en caso contrario, alertar adecuadamente al usuario de que la copia falló.

Sintaxis

Copy( text )

• text – Obligatorio. El texto que se copiará en el portapapeles.

Ejemplos

Entrada de texto con el botón Copiar

La función Copy se puede usar para crear un estilo de controles de entrada que se ve en muchas aplicaciones, donde un botón en este momento para el texto de entrada permite una copia rápida del texto de entrada al portapapeles.

1. Inserte un control Text input en una pantalla. De manera predeterminada, tendrá el nombre TextInput1.
2. Inserte un control Button en la pantalla, junto al control de entrada.
3. Establezca la propiedad OnSelect del botón en Copy( TextInput1.Text ).

Cuando se selecciona el botón, el texto del control de entrada de texto se copiará en el portapapeles.

Procesando texto para poner en el portapapeles

La función Copy acepta texto, que puede ser una expresión que manipula el texto de tu aplicación de alguna manera. Por ejemplo, una aplicación puede tener un registro de empleado que contenga el nombre de pila, apellido, y el cargo del empleado. Una fórmula podría poner esta información en el portapapeles como una pieza de texto. El siguiente ejemplo utiliza la interpolación de cadenas para combinar los datos en una sola cadena:

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