Jaa

Confirm-funktio

  • Artikkeli

Koskee seuraavia: Mallipohjaiset sovellukset

Näytä Vahvistus-ikkuna käyttäjälle.

Description

Muistiinpano

Vahvista-toiminto on tällä hetkellä käytettävissä vain, kun mallipohjaisen sovelluksen Power Fx -komentoja kirjoitetaan.

Confirm-funktio avaa valintaikkunan nykyisen näytön päällä. Käytössä on kaksi painiketta: vahvistus-painike ja peruutus-painike, joiden lokalisoidut oletusarvot ovat OK ja Peruuta. Käyttäjän on tehtävä vahvistus tai peruutus, ennen kuin valintaikkuna hylätään ja funktio palaa. Ikkunan painikkeen lisäksi peruutus voidaan valita myös Esc-näppäimellä tai muilla ympäristökohteisilla eleillä.

Message-parametri näytetään valintaikkunan tekstiosassa. Jos sanoma on pitkä, se voidaan joko lyhentää tai käytössä voi olla vierityspalkki.

Määritä valintaikkunan asetukset OptionsRecord-parametrin avulla. Käytettävät vaihtoehdot vaihtelevat ympäristön mukaan, ja niitä käsitellään mahdollisuuksien mukaan. Näitä valintoja ei tueta pohjaan perustuvissa sovelluksissa.

Asetuskenttä Description
Vahvista-painike confirm-painikkeessa näytettävä oletusarvon korvaava teksti, joka lokalisoidaan OK-tekstiksi.
Peruuta-painike cancel-painikkeessa näytettävä oletusarvon korvaava teksti, joka lokalisoidaan Peruuta-tekstiksi.
Nimike Valintaikkunan otsikkona näytettävä teksti. Tämän tekstin näyttämiseen voidaan käyttää sanoman tekstiä suurempaa, lihavoitua fonttia. Teksti katkaistaan, jos se on liian pitkä.
Alaotsikko Valintaikkunan tekstityksenä näytettävä teksti. Tämän tekstin näyttämiseen voidaan käyttää sanoman tekstiä suurempaa, lihavoitua fonttia. Teksti katkaistaan, jos se on liian pitkä.

Vahvista-funktio palauttaa arvon tosi , jos Vahvista-painike oli valittuna,muussa tapauksessa epätosi .

Notify-funktiota käytetään näyttämään sovelluksen päällä viestipalkki, jota ei tarvitse hylätä.

Syntaksi

Vahvista( Viesti [, OptionsRecord ])

  • Viesti - Pakollinen. Sanoma, joka näytetään käyttäjälle.
  • OptionsRecord - valinnainen. Antaa valintaikkunan asetukset. Käytettävät vaihtoehdot vaihtelevat ympäristön mukaan, ja niitä käsitellään mahdollisuuksien mukaan.

Esimerkkejä

If( Confirm( "Are you sure?" ), Remove( ThisItem ) )

Yksinkertainen vahvistusikkuna, joka pyytää käyttäjää vahvistamaan tietueen poistaminen, ennen kuin se poistetaan. Tietuetta ei poisteta, ellei käyttäjä paina OK-painiketta.

If( Confirm( "Are you sure?", {Title: "Delete Confirmation"} ), Remove( ThisItem ) )

Sama ikkuna kuin edellisessä esimerkissä, mutta tässä lisätään otsikon teksti.

Set( FavColor, 
     If( Confirm( "What is your favorite color?", 
                  { ConfirmButton: "Red", CancelButton: "Green" } 
         ), 
         "Red", 
         "Green" 
     ) 
)

Kysyy käyttäjältä tämän lempiväriä ja tallentaa tuloksen yleiseen muuttujaan. FavColor-parametriin tallennettava tulos on tekstimerkkijono Punainen tai Vihreä. Vahvistuksen oletusvalinta on Punainen. Tämä toimii vain ympäristöissä, jotka tukevat ConfirmButton- ja CancelButton-vaihtoehtoja.

Confirm( "There was a problem, please review your order." )

Näyttää sanoman Notify-funktion tavoin, mutta sanoma on modaalinen ja jatkaminen edellyttää, että käyttäjä valitsee painikkeen. Käytetään, kun on tärkeää, että käyttäjä kuittaa sanoman ennen jatkamista. Tässä tilanteessa valitsemasi painike ei ole tärkeä eikä tulosta tarkisteta.