Função Copy

  • Artigo

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.

  1. Insira um controlo de Text input num ecrã. Por predefinição, o nome será TextInput1.
  2. Introduza um controlo Botão no ecrã, junto ao controlo de entrada.
  3. 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})" )