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

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

  • Стаття

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

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

Опис

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

Нотатка

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

Синтаксис

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

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

Приклади

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

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

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

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

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

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

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