Função Copiar

Aplica-se a: Aplicativos de tela Aplicativos baseados em modelo

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.

1. Insira um controle Text input em uma tela. Por padrão, o nome será TextInput1.
2. Insira um controle de Botão na tela, ao lado do controle de entrada.
3. 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})" )