Dalintis per


Dialog Kontrolė (eksperimentinė)

[Šis straipsnis yra negalutinio leidimo dokumentacija ir gali keistis.]

Valdiklis, naudojamas turiniui grupuoti.

Dialogo valdiklis.

Svarbu

  • Ši funkcija yra eksperimentinė.
  • Peržiūros funkcijos nėra skirtos naudoti gamybai ir gali būti apribotas jų funkcionalumas. Šias funkcijas galima naudoti prieš oficialų išleidimą, kad klientai galėtų gauti ankstyvą prieigą ir pateikti atsiliepimų.

Aprašą

Dialogo langas (dialogas) – tai laikinasis iššokantis langas, nukreipiantis dėmesį nuo puslapio ar programos ir reikalaujantis interakcijos. Jis daugiausia naudojamas veiksmams patvirtinti, pvz., failui panaikinti, ar prašant žmonių pasirinkti.

Šis drobės komponentas imituoja „Fluent UI” dialogo lango valdiklio stilių ir elgesį. Geriausios praktikos ieškokite dokumentacijoje.

Peržiūrėkite komponentą "Creator Kit GitHub" saugykloje.

Ypatybės

Raktų ypatybės

Ypatybė Aprašą
Buttons Duomenų rinkinys, apibrėžiantis mygtukus (daugiau sužinokite skiltyje Mygtuko ypatybės).
Title Pavadinimo skyriuje rodomas tekstas.
OverlayColor Viršije srityje rodoma spalva.
DialogWidth Dialogo lango plotis (nepainioti su valdiklio pločiu, kuris turėtų apimti programos plotį).
DialogHeight Dialogo lango aukštis (nepainioti su valdiklio aukščiu, kuris turėtų apimti programos aukštį).
SubTitle Po pavadinimu rodomas tekstas.

Mygtukų ypatybės

Ypatybė Aprašą
Label Žyma, rodoma mygtuke.
ButtonType Išvardijimas, kuris nurodo mygtuko stilių. Rinkitės tarp Standard ir Primary.
Table(
    {
        Label: "Cancel", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Standard 
    },{
        Label: "Ok", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Primary
    }
)

Stiliaus ypatybės

Ypatybė Aprašą
Theme Temos objektas. Sužinokite daugiau apie temą.

Sužinokite apie formatavimą skydelio turinio skyriuje Formatavimas.

Renginio ypatybės

Ypatybė Aprašą
OnCloseSelect Veiksmo išraiška vykdoma pasirinkus uždarymo mygtuką.
OnButtonSelect Veiksmo išraiška vykdoma pasirinkus vieną iš veiksmo mygtukų.

Elgsena

Dialogo lango matomumo konfigūravimas

Padarykite Dialog patį valdiklį (arba paviršių, kuriame jis yra) matomą, kai Bulio logikos (teisinga/klaidinga) kintamasis pasikeičia į teisingą. Priskirkite šį kintamąjį dialogo matomumo ypatybei. Norėdami paslėpti dialogo langą, kai jis rodomas, atnaujinkite kintamąjį ypatybėje iš naujo, suaktyvintą pasirinkus uždarymo piktogramą.

Toliau pateikta „Power Fx” formulė atidaryti dialogo langą veiksmo formulėje kitame programos komponente (pvz., OnSelect mygtuko ypatybėje):

UpdateContext({ showHideDialog: true })

Toliau pateikta „Power Fx” formulė uždaryti dialogo langą OnCloseSelect dialogo lango ypatybėje:

UpdateContext({ showHideDialog: false })

Priskirkite kintamąjį dialogo lango Visible ypatybėms:

showHideDialog

Mygtukų veiksmų konfigūravimas

Dialogo lango OnButtonSelect ypatybėje pateikite veiksmus su If() arba Switch() sąlyga pagal Self.SelectedButton.Label teksto reikšmę veiksmui apibrėžti. Priklausomai nuo veiksmo, gali būti prasminga ir jį baigus uždaryti dialogo langą.

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

Apribojimai

Šį drobės komponentą galima naudoti tik drobės programose ir pasirinktiniuose puslapiuose.