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

Dialog контрольний (експериментальний)

  • Стаття

[Ця стаття стосується попередньої версії, і її буде змінено.]

Елемент керування, який використовується для групування вмісту.

Діалогове керування.

Важливо

  • Це експериментальна функція.
  • Експериментальні функції призначено для невиробничого використання, і вони можуть бути обмежені. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки.

Опис

Діалогове вікно (діалог) – це тимчасове спливаюче вікно, яке встановлює фокус зі сторінки або програми та вимагає взаємодії з боку користувача. Передусім воно використовується для підтвердження дій, наприклад видалення файлу, або пропонує користувачу зробити вибір.

Цей компонент полотна імітує стиль і поведінку елемента керування Fluent UI Dialog. Див. документацію для отримання рекомендацій.

Перегляньте компонент у репозиторії Creator Kit на GitHub.

Властивості

Ключові властивості

Властивість Опис
Buttons Набір даних, який визначає кнопки (див. властивості нижче)
Title Текст, який відображається в розділі заголовка
OverlayColor Колір, який відображається в області накладання
DialogWidth Ширина діалогового вікна (не плутати з шириною елемента керування, який має займати ширину програми)
DialogHeight Висота діалогового вікна (не плутати з висотою елемента керування, який має займати висоту програми)
SubTitle Текст, який відображається під заголовком

Buttons Властивості

Властивість Опис
Label Надпис, що відображається на кнопці.
ButtonType Значення, яке визначає стиль кнопки. Виберіть між Standard та Primary. 
Table(
    {
        Label: "Cancel", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Standard 
    },{
        Label: "Ok", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Primary
    }
)

Властивості стилю

Властивість Опис
Theme Об’єкт теми. Див. використання тем, щоб отримати вказівки щодо налаштування.

Докладніші відомості про форматування див. рекомендації в пункті «Форматування вмісту панелі» в розділі Панель.

Властивості події

Властивість Опис
OnCloseSelect Вираз дії, який виконується внаслідок натискання кнопки «Закрити».
OnButtonSelect Вираз дії, який виконується внаслідок натискання однієї з кнопок дії.

Поведінка

Налаштування видимості діалогового вікна

Зробіть сам елемент керування Dialog (або область його розташування) видимим, коли змінна типу «Логічне значення» (true/false) змінюється на true, і призначте цю змінну властивості «Видимість діалогового вікна». Після відображення діалогового вікна його можна приховати, оновивши змінну для властивості скидання, яка запускається після вибору піктограми закриття.

У наведеній нижче формулі Power Fx показано, як відкрити діалог у формулі дії для іншого компонента в іншому місті програмі (наприклад, властивість OnSelect кнопки):

UpdateContext({ showHideDialog: true })

Нижче наведено формулу Power Fx для закриття діалогового вікна у властивості OnCloseSelect діалогового вікна:

UpdateContext({ showHideDialog: false })

Призначте змінну властивості Visible діалогового вікна:

showHideDialog

Налаштування дій кнопки

У властивості діалогового вікна OnButtonSelect надайте дії в умові If() або Switch() на основі текстового значення Self.SelectedButton.Label для визначення дії. Залежно від дії може бути доцільно також закрити діалогове вікно після завершення дії.

    If( Self.SelectedButton.Label = "Send", 
        Notify("Email Sent")
    );
    UpdateContext({ showHideDialog: false })

Обмеження

Цей компонент полотна можна використовувати лише в компонованих програмах і настроюваних сторінках.