Функция копирования

Применимо к: приложениям на основе холста приложениям на основе модели

Копирует текст в буфер обмена на устройстве, на котором запущено приложение.

Описание:

Функция Копировать берет любое текстовое значение и копирует его в буфер обмена. Независимо от содержимого текста буфер обмена будет содержать обычный текст без специального типа MIME. Функция считается функцией с побочными эффектами, поэтому ее можно использовать только в свойствах поведения.

Заметка

Функция Копировать() ограничена доступом к буферу обмена, предоставленным узлом приложения. В результате сценарии встроенных приложений, такие как Power Apps в SharePoint, встроенные приложения в Power BI, Teams и т. д. не поддерживают Копирование(). Другие встроенные сценарии также могут не поддерживать эту функцию. Создателям следует использовать IfError(), чтобы гарантировать эффективность действия по копированию в буфер обмена , а в противном случае следует должным образом предупредить пользователя о том, что копирование не удалось.

Синтаксис

Копировать( текст )

  • текст — обязательный аргумент. Текст для копирования в буфер обмена.

Примеры

Ввод текста с помощью кнопки копирования

Функцию Копировать можно использовать для создания стиля элементов управления вводом, который можно увидеть во многих приложениях, где кнопка для ввода текста позволяет быстро скопировать введенный текст в буфер обмена.

  1. Вставьте элемент управления Text input на экран. По умолчанию ему будет присвоено имя TextInput1.
  2. Вставьте элемент управления Кнопка на экран рядом с элементом управления для ввода текста.
  3. Задайте для свойства кнопки OnSelect значение Copy( TextInput1.Text ).

При выборе кнопки текст из элемента управления вводом текста будет скопирован в буфер обмена.

Обработка текста для размещения в буфере обмена

Функция Копировать принимает текст, который сам по себе может быть выражением, выполняющим операции с текстом из вашего приложения. Например, в приложении может быть запись о сотруднике, содержащая имя, фамилия, и должность сотрудника. Формула может разместить эту информацию в буфер обмена как один фрагмент текста. В следующем примере используется интерполяция строк для объединения данных в одну строку:

Copy( $"{employeeRecord.Name} {employeeRecord.LastName} ({employeeRecord.Title})" )