Jaa

Dialog kontrolli (kokeellinen)

  • Artikkeli

[Tämä artikkeli sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Sisällön ryhmittelyyn käytetty ohjausobjekti.

Dialog-ohjausobjekti

Tärkeä

  • Tämä on kokeellinen ominaisuus.
  • Kokeiluversion ominaisuuksia ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnallisuus voi olla rajoitettu. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niiden ennakkojulkaisua ja antaa palautetta.

Description

Valintaikkuna (Dialog) väliaikainen ponnahdusikkuna, joka siirtää kohdistuksen sivulta tai sovelluksesta ja joka edellyttää käyttäjän vuorovaikutusta. Sitä käytetään lähinnä toimintojen, kuten tiedoston poistamisen, vahvistamiseen tai valintojen tekemiseen.

Pohjaan perustuva sovellus matkii Fluent UI:n Dialog-ohjausobjektin tyyliä ja toimintaa. Katso parhaat käytännöt dokumentaatiosta.

Tarkastele komponenttia Creator Kitin GitHub-säilössä.

Ominaisuudet

Tärkeimmät ominaisuudet

Ominaisuus Description
Buttons Painikkeet määrittävä tietojoukko (katso ominaisuudet alta)
Title Otsikko-osiossa näkyvä teksti
OverlayColor Peittoalueella näkyvä väri
DialogWidth Valintaikkunan leveys (joka on eri asia kuin ohjausobjektin leveys, jonka pitäisi olla yhtä leveä kuin sovellus)
DialogHeight Valintaikkunan korkeus (joka on eri asia kuin ohjausobjektin korkeus, jonka pitäisi olla yhtä korkea kuin sovellus).
SubTitle Otsikon alla näkyvä teksti

Buttons Majoituspaikkaa

Ominaisuus Description
Label Painikkeessa näkyvä selite.
ButtonType Painikkeen tyylin määrittävä luettelointi. Valitse Standard tai Primary. 
Table(
    {
        Label: "Cancel", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Standard 
    },{
        Label: "Ok", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Primary
    }
)

Tyylin ominaisuudet

Ominaisuus Description
Theme Teema-objekti. Katso määritysohjeet kohdasta Teemat.

Katso muotoiluohjeet Panel-ohjausobjektin Muotoile-paneelin sisältöosiosta.

Tapahtuman ominaisuudet

Ominaisuus Description
OnCloseSelect Toimintolauseke, joka suoritetaan, kun sulkemispainike valitaan.
OnButtonSelect Toimintolauseke, joka suoritetaan, kun jokin toimintopainike valitaan.

Toiminta

Valintaikkunan näkyvyyden määrittäminen

Itse Dialog-ohjausobjekti (tai pinta, jossa se sijaitsee) tulee näkyväksi, kun totuusarvon (tosi/epätosi) tyyppimuuttujaksi vaihtuu tosi, ja tämä muuttuja määritetään valintaikkunan näkyvyysominaisuuteen. Kun valintaikkuna on näkyvissä, valintaikkuna voidaan piilottaa päivittämällä nollausominaisuuden muuttuja, mikä käynnistyy, kun sulkemiskuvake valitaan.

Alla on Power Fx -kaava, joka avaa valintaikkunan toisen komponentin toimintokaavassa jossain sovelluksen osassa (esimerkiksi painikkeen OnSelect-ominaisuus):

UpdateContext({ showHideDialog: true })

Alla on Power Fx -kaava, joka sulkee valintaikkunan sen OnCloseSelect-ominaisuudessa:

UpdateContext({ showHideDialog: false })

Muuttujan määrittäminen ikkunan Visible-ominaisuuteen:

showHideDialog

Painikkeen toimintojen määrittäminen

Toiminnon määrittäminen antamalla valintaikkunan OnButtonSelect-ominaisuudessa If()- tai Switch()-ehdon toiminnot Self.SelectedButton.Label-tekstiarvon perusteella. Toiminnon mukaan kannattaa myös ehkä sulkea valintaikkuna sen jälkeen, kun toiminto on suoritettu.

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

Rajoitukset

Tätä pohjaan perustuvaa komponenttia voi käyttää vain pohjaan perustuvissa sovelluksissa ja mukautetuilla sivuilla.