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

Стаття
12/11/2024

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

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

Опис

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

Нотатка

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

Синтаксис

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

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

Приклади

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

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

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

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

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

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

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

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