Funzione Copia
Si applica a:
App Canvas App basate su modello
Copia il testo negli appunti sul dispositivo su cui è in esecuzione l'app.
Description
La funzione Copia prende qualsiasi valore di testo e lo copia negli appunti. Indipendentemente dal contenuto del testo, gli appunti conterranno il testo normale senza alcun tipo di mime speciale. La funzione è considerata una funzione con effetti collaterali e di conseguenza può essere utilizzata solo nelle proprietà del comportamento.
Nota
La funzione Copy() è limitata all'accesso concesso agli appunti dall'host dell'app. Di conseguenza, scenari di app incorporate come Power Apps in SharePoint, app incorporate in Power BI, Teams e così via non supportano Copy(). Anche altri scenari incorporati potrebbero non supportare la funzione. Gli autori dovrebbero utilizzare IfError() per fare in modo che l'azione di copia negli Appunti sia efficace e, in caso contrario, per avvisare adeguatamente l'utente che la copia non è riuscita.
Sintassi
Copia( testo )
- testo - Obbligatorio. Il testo da copiare negli Appunti.
Esempi
Input di testo con pulsante Copia
La funzione Copia può essere utilizzata per creare uno stile di controlli di input visto in molte app, dove un pulsante accanto al testo di input consente una copia rapida del testo di input negli appunti.
- Inserire un controllo Text input in una schermata. Per impostazione predefinita il nome sarà TextInput1.
- Inserisci un controllo Button sullo schermo, accanto al controllo di input.
- Imposta la proprietà OnSelect su Copy( TextInput1.Text ).
Quando il pulsante è selezionato, il testo dal controllo di immissione del testo verrà copiato negli appunti.
Elaborazione del testo da inserire negli appunti
La funzione Copia accetta il testo, che può essere un'espressione che manipola in qualche modo il testo dalla tua app. Ad esempio, un'app può avere un record del dipendente che contiene il nome, cognome, e il titolo del dipendente. Una formula potrebbe inserire queste informazioni negli appunti come una parte di testo. L'esempio seguente utilizza l'interpolazione di stringa per combinare i dati in una stringa:
Copy( $"{employeeRecord.Name} {employeeRecord.LastName} ({employeeRecord.Title})" )