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

Функція копіювання

  • Стаття

Застосовується до: програм Canvas Програм на основі моделі

Копіює текст у буфер обміну на пристрої, де запущено програму.

Опис

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

Нотатка

Функція Copy() обмежена доступом, наданим буферу обміну хостом програми. Як наслідок, сценарії вбудованих програм, такі як Power Apps in SharePoint, embedded apps in Power BI, Teams тощо, не підтримують Copy(). Інші вбудовані сценарії також можуть не підтримувати цю функцію. Виробники повинні використовувати IfError(), щоб переконатися, що дія з копіювання в буфер обміну була ефективною, а якщо ні, належним чином попередити користувача про те, що копіювання не вдалося.

Синтаксис

Копія ( текст )

  • text - Обов’язковий. Текст, який потрібно скопіювати в буфер обміну.

Приклади

Введення тексту за допомогою кнопки копіювання

Функцією «Копіювати » можна скористатися для створення стилю елементів керування вводу, який можна побачити у багатьох програмах, де кнопка введеного тексту дозволяє швидко скопіювати текст вхідних даних до буфера обміну.

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

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

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

Функція копіювання приймає текст, який сам по собі може бути виразом, який певним чином маніпулює текстом із вашого додатка. Наприклад, додаток може мати запис працівника, який містить ім’я, прізвище та посаду працівника. Формула може помістити цю інформацію в буфер обміну як один фрагмент тексту. У наступному прикладі використовується інтерполяція рядків для об’єднання даних в один рядок:

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