Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
Aplicativos de tela
Copia texto para a área de transferência do dispositivo em que a aplicação está em execução.
Descrição
A Copy função pega qualquer valor de texto e o copia para a área de transferência. Independentemente do conteúdo do texto, a área de transferência conterá texto simples sem qualquer tipo de mime especial. A função é considerada uma função de efeitos secundários e, como resultado, só pode ser utilizada nas propriedades do comportamento.
Nota
A Copyfunção () é limitada ao acesso dado à área de transferência pelo host do aplicativo. Como resultado, cenários de aplicativos incorporados, como Power Apps no SharePoint, aplicativos incorporados no Power BI, Teams, etc. não suportam Copy(). Outros cenários incorporados também podem não suportar a função. Os criadores devem utilizar IfError() para assegurar que a ação para copiar para a área de transferência foi eficaz e, caso contrário, para alertar adequadamente o utilizador de que a cópia falhou.
Sintaxe
Copy( texto )
- text - Obrigatório. O texto a copiar para a área de transferência.
Exemplos
Entrada de texto com Copy botão
A Copy função pode ser usada para criar um estilo de controles de entrada visto em muitos aplicativos, onde um botão agora para o texto de entrada permite uma cópia rápida do texto da entrada para a área de transferência.
- Insira um controlo de Text input num ecrã. Por predefinição, o nome será TextInput1.
- Introduza um controlo Botão no ecrã, junto ao controlo de entrada.
- Defina a propriedade OnSelect do botão como Copy( TextInput1.Text ).
Quando o botão é selecionado, o texto do controlo de introdução de texto será copiado para a área de transferência.
Processar texto a colocar na área de transferência
A Copy função aceita texto, que pode ser uma expressão que manipula o texto do seu aplicativo de alguma forma. Por exemplo, uma aplicação pode ter um registo do empregado com o nome próprio, apelido e função do empregado. Uma fórmula poderia colocar estas informações na área de transferência como um elemento de texto. O exemplo que se segue utiliza a interpolação de cadeias para combinar os dados numa única cadeia:
Copy( $"{employeeRecord.Name} {employeeRecord.LastName} ({employeeRecord.Title})" )