Властивості компонента полотна (експериментальна функція)

Стаття
01/25/2024

Компоненти Canvas дозволяють виробникам створювати різні типи властивостей для передачі значень або логіки між компонентом і програмою, у якій розміщено компонент. Властивості є невід’ємною частиною створення інтерактивних і багаторазово використовуваних компонентів.

Важливо

Це експериментальна функція.
Експериментальні функції призначено для невиробничого використання, і вони можуть бути обмежені. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки. Додаткова інформація: Експериментальні та підготовчі функції
Поведінка, описана в цій статті, доступна, лише якщо експериментальну функцію Розширені властивості компонентів у меню Настройки > Майбутні функції > Експериментальні функції ввімкнено (за замовчуванням вимкнено).
Ваш відгук дуже цінний для нас - будь ласка, поділіться з нами своєю думкою на форумі спільноти Power Apps експериментальних функцій.

Види об’єктів нерухомості

Виробникам доступні чотири типи властивостей:

Властивості даних: властивості даних стосуються даних, як-от колір або текстове значення. Властивість Data може бути встановлена як Input або Output, що вказує на те, чи надає компонент дані програмі (Output) або app надає дані компоненту (Input). Властивості даних – це єдині ресурси, які беруть участь у потоці даних додатка.
Властивості функції: властивості функцій пов’язані з логікою, наприклад, виконання обчислень на основі певних параметрів або зміна тексту. Властивість Function може бути встановлена як Input або Output, що вказує на те, чи надає компонент функцію, яку додаток може викликати (Output), або app надає функцію, яку компонент може викликати (Input). Властивості функцій не беруть участі в потоці даних додатка та не можуть використовувати компоненти або змінні додатка.
Властивості дії: Властивості дії — це тип властивості, який має справу з логікою та поводиться як функція виведення ·. Таким чином, компонент має визначену логіку, і ця логіка може використовувати ланцюжкові вирази та маніпулювати колекціями або змінними («поведінка»). Наприклад, Clear() властивість Дія може надавати функції, які може викликати додаток, щоб очистити деякі значення в компоненті, або Save() властивість Дія, яка оновлює джерело даних.
Властивості події: Властивості події – це категорія властивостей, яка включає логіку та функціонує як вхідна функція. Таким чином, додаток визначає логіку, яку може викликати компонент, і ця логіка може використовувати ланцюжкові вирази та маніпулювати колекціями або змінними («поведінка»). Як правило, назви цих властивостей відображають таку подію, як OnSelect або OnChanged.

Властивість даних

Використання властивості даних легко уявити. Стандартні елементи керування в програмах зазвичай мають кілька властивостей даних, за допомогою яких можна встановити значення за умовчанням, колір тексту, розмір тощо. Давайте розглянемо простий приклад, коли ми хочемо зробити властивості елемента керування в компоненті доступними для хостинг-програми. У цьому прикладі наш компонент має ім’я Component1. Ми помістимо повзунок всередину нашого компонента. У нас буде властивість Input для визначення кольору з програми-споживача, і властивість Output, де компонент може повідомити додатку, яке поточне значення повзунка. У наведеному нижче прикладі припускається, що ваш компонент містить елемент керування «Повзунок» з Slider іменем.

На панелі властивостей компонента виберіть Нова настроювана властивість.
На панелі Нова настроювана властивість введіть коротке ім’я Slider Color.
Виберіть Тип властивості Дані та виберіть Значення визначення властивості Вхідні дані.
Нарешті, у розкривному списку Тип даних виберіть Колір.
Натисніть Створити.

Далі виберіть елемент Slider1 керування «Повзунок ». Знайдіть його властивість ValueFill і в рядку формул введіть Component1.SliderColor команду. Component1 посилається на ім’я нашого компонента і SliderColor є ім’ям властивості, яку ми додали раніше.

Тепер наш компонент має SliderColor властивість, яку можна встановити в додатку-споживанні, щоб передати колір компоненту, щоб встановити властивість повзунка ValueFill .

Ми також хочемо надати значення повзунка для програми-споживача. Для цього ми додамо властивість Output .

На панелі властивостей компонента виберіть Нова настроювана властивість.
На панелі Нова настроювана властивість введіть коротке ім’я Slider Value.
Виберіть Тип властивості Дані та виберіть Значення визначення властивості Виведення.
Нарешті, у розкривному списку Тип даних виберіть Кількість.
Натисніть Створити.

Коли властивість Data має значення Output, компонент надає значення програмі-споживачу. Щоб задати формулу для цього, нам потрібно задати властивість new SliderValue в компоненті властивість Value повзунка.

На панелі властивостей компонента натисніть на властивість Slider Value .
У рядку формул замініть значення за замовчуванням такою 100 формулою: Slider1.Value.

Тепер властивість нашого компонента SliderValue буде відображати значення повзунка всередині компонента, яке потім можна прочитати з додатку-споживача.

Властивість функції

Властивість функції містить вираз, який повертає значення. Як правило, функція приймає деякі аргументи, які вона використовує для обчислення або визначення значення, яке потрібно повернути.

Примітка

Властивості функції наразі не можуть отримати доступ до змінних або значень і властивостей компонентів, а також не можуть ініціювати потік даних. Будь-які обов’язкові значення мають бути передані як аргументи.

Функція Output — це простий спосіб створити користувацьку функцію для Power Apps. Компонент визначає функцію Output за допомогою виразу, який приймає деякі аргументи та повертає значення. Потім цю функцію можна використовувати в програмі, використовуючи ім’я компонента (скажімо Component1) за допомогою виклику Component1.MyFunction(arg1, arg2).

Функція вводу — це спосіб, за допомогою якого програма-споживач надає логіку компоненту, подібно до вказівника функції або функції зворотного виклику. Наприклад, ваш компонент може мати справу з іменами людей і мати функцію вводу з аргументами firstname та lastname поважати рядок назад. Додаток може визначити вираз функції, який потрібно повернути $"{firstname} {lastname}" , або визначити вираз для $"{lastname}, {firstname}". Компонент може просто викликати функцію, надану розробником програми, і використовувати повернутий рядок.

Властивість дії

Властивості дії подібні до властивостей функцій типу Output, але вони дозволяють формули побічних ефектів та ланцюжок виразів. Компонент може мати властивість AddRecord action, яка дозволяє програмі додавати запис до колекції всередині компонента, або Reset дію, яка очищає змінні чи колекції всередині компонента.

У прикладі повзунка, який використовувався для властивості Data раніше, ми можемо представити властивість action, яка викликається ResetValue для повернення повзунка до значення за замовчуванням. Для цього можна скористатися формулою Reset( Slider1 ) . Тепер екземпляри нашого компонента в додатку можуть викликати Component1.ResetValue() виклик, щоб повернути повзунок до значення за замовчуванням.

Об’єкт події

Існує багато загальних властивостей типу Event, які ефективно вводять властивості функції поведінки, у стандартних елементах керування. OnSelect на кнопці управління є найочевиднішим прикладом. Компонент може визначати будь-яку кількість властивостей події та викликати ці події як функцію. Наприклад, компонент, який має елемент керування кнопкою, може мати назву OnButtonClicked властивості події. У кнопці control OnSelect компонент може викликати свою Component1.OnButtonClicked() властивість. Потім програма-споживач може визначити власну логіку для цієї властивості, щоб діяти, коли натискається кнопка всередині компонента.

Значення за замовчуванням для властивостей або аргументів

Значення за замовчуванням можуть надавати значення за замовчуванням для аргументу або властивості, якщо їх не встановлено. Для деяких типів об’єктів нерухомості це не має сенсу. Однак у деяких випадках вони можуть бути використані для створення очікуваної схеми для запису. Надаючи запис за замовчуванням, тип запису встановлюється як очікувана схема.

Наприклад, властивість «Дія » з ім’ям AddRecord приймає запис для додавання до локальної колекції. Щоб надати схему очікуваного запису, виробник повинен додати значення за замовчуванням для аргументу цієї AddRecord властивості.

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