Властивості компонента полотна (підготовча версія)

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

вимоги

Перш ніж ви зможете використовувати цю функцію, її потрібно ввімкнути в налаштуваннях програми.

1. Відкрийте програму полотна для редагування Power Apps Studio. На панелі команд виберіть Оновлення> налаштувань.

2. На вкладці Попередній перегляд знайдіть і ввімкніть параметри Розширені властивості компонентів.

Види нерухомості

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Властивість заходу

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

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

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

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