Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
aplicativos Canvas
Copia o texto para a área de transferência no dispositivo em que o aplicativo está sendo executado.
Description
A Copy função usa qualquer valor de texto e a copia para a área de transferência. Independentemente do conteúdo do texto, a área de transferência conterá texto simples sem nenhum tipo mime especial. A função é considerada uma função de efeitos colaterais e, como resultado, só pode ser usada em propriedades de comportamento.
Observação
A Copyfunção () é limitada ao acesso dado à área de transferência pelo host do aplicativo. Como resultado, cenários de aplicativos inseridos, como o Power Apps no SharePoint, aplicativos inseridos no Power BI, Teams etc. não dão suporte Copy(). Outros cenários incorporados talvez também não sejam compatíveis com a função. Os criadores devem usar IfError() para garantir que a ação de copiar para a área de transferência foi eficaz e, do contrário, alertar devidamente o usuário de que houve falha na cópia.
Sintaxe
Copy( texto )
- texto - Obrigatório. O texto a ser copiado na á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 vistos em muitos aplicativos, em que 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 controle Text input em uma tela. Por padrão, o nome será TextInput1.
- Insira um controle de Botão na tela, ao lado do controle de entrada.
- Defina a propriedade OnSelect do botão como Copy( TextInput1.Text ).
Quando o botão for selecionado, o texto do controle de entrada de texto será copiado para a área de transferência.
Processar texto para colocar na área de transferência
A Copy função aceita texto, que pode ser uma expressão que manipula o texto de seu aplicativo de alguma forma. Por exemplo, um aplicativo pode ter um registro de funcionário que contenha o nome, o sobrenome e o título do funcionário. Uma fórmula pode colocar essas informações na área de transferência como um texto. O exemplo a seguir usa interpolação de cadeia de caracteres para combinar os dados em uma string:
Copy( $"{employeeRecord.Name} {employeeRecord.LastName} ({employeeRecord.Title})" )