Função Copiar
Aplica-se a:
Aplicativos Canvas Aplicativos baseados em modelos
Copia o texto para a área de transferência no dispositivo em que o aplicativo está sendo executado.
Description
A função Copiar 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 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 função Copy() é limitada ao acesso dado à área de transferência pelo host do aplicativo. Como resultado, cenários de aplicativos incorporados, como o Power Apps no SharePoint, aplicativos incorporados no Power BI, no Teams etc., não dão suporte a 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
Copiar( texto )
- texto - Obrigatório. O texto a ser copiado na área de transferência.
Exemplos
Entrada de texto com botão Copiar
A função Copiar 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 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 função Copiar 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})" )