Função Copy
Aplica-se a:
Aplicativos de tela Aplicativos controlados por modelo
Copia texto para a área de transferência do dispositivo em que a aplicação está em execução.
Descrição
A função Copiar retira qualquer valor de texto e copia-o 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 função Copy() está limitada ao acesso dado à área de transferência pelo anfitrião da aplicação. Como resultado, os cenários das aplicações incorporadas, tais como o Power Apps no SharePoint, aplicações incorporadas no Power BI, Teams, etc., não suportam a função 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
Cópia ( texto )
- text - Obrigatório. O texto a copiar para a área de transferência.
Exemplos
Introdução de texto com o botão Copiar
A função Copiar pode ser utilizada para criar um estilo de controlos de entrada em várias aplicações, onde um botão para o texto de introdução permite uma cópia rápida do texto da introdução 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 função Copiar aceita texto, que pode ser uma expressão que manipula texto da sua aplicação 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})" )