Поделиться через


Copy функция

Применимо к: приложениям Canvas

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

Описание:

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

Заметка

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

Синтаксис

Copy( текст )

  • текст - Обязательно. Текст для копирования в буфер обмена.

Примеры

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

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

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

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

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

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

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