Funkcija UpdateContext
Velja za:
aplikacije Canvas
Ustvari ali posodobi spremenljivke konteksta za trenutni zaslon.
Pregled
Uporabite funkcijo UpdateContext, da ustvarite spremenljivko konteksta, ki začasno vsebuje na primer podatek, kolikokrat je uporabnik izbral gumb ali kakšen je rezultat podatkovne operacije.
Spremenljivke konteksta so dodeljene zaslonu, kar pomeni, da ne morete sestaviti formule, ki se nanaša na spremenljivko konteksta na drugem zaslonu. Če ste uporabili drugo orodje za programiranje, si spremenljivko konteksta predstavljajte podobno lokalni spremenljivki. Uporabite funkcijo Set za obdelavo globalnih spremenljivk, ki so na voljo v vaši aplikaciji.
Aplikacije Power Apps temeljijo na formulah, ki se samodejno preračunajo, ko uporabnik uporablja aplikacijo. Spremenljivke konteksta ne ponujajo te prednosti, kar lahko oteži ustvarjanje in razumevanje vaše aplikacije. Preden uporabite spremenljivko konteksta, glejte temo o delu s spremenljivkami.
Opis
Če želite ustvariti ali posodobiti spremenljivko konteksta, v funkcijo UpdateContext posredujte en zapis. V vsakem zapisu navedite ime stolpca, ki določa ali se ujema z imenom spremenljivke, in vrednost, na katero želite nastaviti to spremenljivko.
- Če navedete ime spremenljivke, ki ste jo že določili, funkcija UpdateContext nastavi vrednost spremenljivke na vrednost, ki jo določite.
- Če določite ime spremenljivke, ki še ne obstaja, funkcija UpdateContext ustvari spremenljivko s tem imenom in nastavi vrednost te spremenljivke na vrednost, ki jo določite.
- Če ste že določili spremenljivko, vendar je niste navedli v točno tej formuli UpdateContext, njena vrednost ostane enaka.
Spremenljivke konteksta so implicitno ustvarjene s funkcijo UpdateContext ali Navigate. Izrecna izjava ni potrebna. Če odstranite vse sklice funkcij UpdateContext in Navigate na spremenljivko konteksta, potem bo ta spremenljivka konteksta prenehala obstajati. Če želite izbrisati spremenljivko, nastavite njeno vrednost na rezultat funkcije Blank.
Vrednosti, definicije in uporabe spremenljivk so prikazane v pogledu »Spremenljivke« v meniju Datoteka v okolju za ustvarjanje.
Na spremenljivko konteksta v formuli se sklicujete z imenom stolpca spremenljivke. UpdateContext( { ShowLogo: true } ) na primer ustvari spremenljivko konteksta ShowLogo in nastavi njeno vrednost na true. Vrednost te spremenljivke konteksta lahko nato uporabite z imenom ShowLogo v formuli. ShowLogo lahko zapišete kot formulo za lastnost Visible za kontrolnik slike ter prikažete ali skrijete ta kontrolnik glede na to, ali je vrednost spremenljivke konteksta true ali false.
Kot kažejo primeri v nadaljevanju te teme, lahko spremenljivke konteksta vsebujejo več vrst informacij, vključno s temi:
- ena vrednost
- zapis
- tabela
- sklic na predmet
- kakršenkoli rezultat iz formule
Spremenljivka konteksta ohrani svojo vrednost, dokler se aplikacija ne zapre. Če določite spremenljivko konteksta in nastavite njeno vrednost na določenem zaslonu, ostanejo ti podatki nedotaknjeni, tudi če uporabnik preklopi na drug zaslon. Ko se aplikacija zapre, se vrednost spremenljivke konteksta izgubi in jo je treba znova ustvariti, ko se aplikacija znova naloži.
Vsaka spremenljivka konteksta je dodeljena zaslonu. Če želite določiti spremenljivko konteksta na enem zaslonu in spremeniti to spremenljivko z drugega zaslonu, morate sestaviti formulo, ki temelji na funkciji Navigate. Lahko pa uporabite globalno spremenljivko.
Funkcija UpdateContext ne vrne nobene vrednosti in jo lahko uporabite samo v formuli za delovanje.
Sintaksa
UpdateContext( UpdateRecord )
- UpdateRecord – obvezno. Zapis, ki vsebuje ime vsaj enega stolpca in vrednost za ta stolpec. Spremenljivka konteksta se ustvari ali posodobi za vsak stolpec in vrednost, ki ju navedete.
UpdateContext( { ContextVariable1: Value1 [, ContextVariable2: Value2 [, ... ] ] } )
- ContextVariable1 – obvezno. Ime spremenljivke konteksta za ustvarjanje ali posodobitev.
- Value1 – obvezno. Vrednost, ki je dodeljena spremenljivki konteksta.
- ContextVariable2: Value2, ... – neobvezno. Dodatne spremenljivke konteksta za ustvarjanje ali posodobitev in njihove vrednosti.
Primeri
| Formula | Opis | Rezultat |
|---|---|---|
| UpdateContext( { Counter: 1 } ) | Ustvari ali spremeni spremenljivko konteksta Counter in nastavi njeno vrednost na 1. | Counter ima vrednost 1. Na to spremenljivko se lahko sklicujete z imenom Counter v formuli. |
| UpdateContext( { Counter: 2 } ) | Nastavi vrednost spremenljivke konteksta Counter iz prejšnjega primera na 2. | Counter ima vrednost 2. |
| UpdateContext( { Name: "Lily", Score: 10 } ) | Ustvari ali spremeni spremenljivki konteksta Name in Score ter nastavi njuni vrednosti na Lili oziroma 10. | Name ima vrednost Lily in Score ima vrednost 10. |
| UpdateContext( { Person: { Name: "Milton", Address: "1 Main St" } } ) | Ustvari ali spremeni spremenljivko konteksta Person in nastavi njeno vrednost na zapis. Zapis vsebuje dva stolpca, imenovana Name in Address. Vrednost stolpca Name je Milton, vrednost stolpca Address pa 1 Main St. | Person ima vrednost zapisa { Name: "Milton", Address: "1 Main St" } }. Navedite celoten zapis z imenom Person ali posamezen stolpec tega zapisa s Person.Name ali Person.Address. |
| UpdateContext( { Person: Patch( Person, {Address: "2 Main St" } ) } ) | Deluje s funkcijo Patch in posodobi spremenljivko konteksta Person tako, da nastavi vrednost stolpca Address na 2 Main St. | Person ima zdaj vrednost zapisa { Name: "Milton", Address: "2 Main St" } }. |
Primer po korakih 1
Privzeti zaslon poimenujte Cilj, nato pa dodajte še en zaslon in ga poimenujte Cilj.
Na zaslonu Vir dodajte dva gumba in nastavite njuni lastnosti Text na English in Spanish.
Nastavite lastnost OnSelect gumba Angleščina na ta izraz:
Navigate(Target, ScreenTransition.Fade, {Language:"English"})Nastavite lastnost OnSelect gumba Španščina na ta izraz:
Navigate(Target, ScreenTransition.Fade, {Language:"Spanish"})Na zaslonu Cilj dodajte oznako in nastavite njeno lastnost Besedilo na ta izraz:
If(Language="English", "Hello!", "Hola!")Na zaslonu Cilj izberite Oblike na zavihku Vstavljanje in nato izberite puščico nazaj.
Lastnost OnSelect puščice nazaj nastavite na to formulo:
Navigate(Source, ScreenTransition.Fade)Na zaslonu Vir pritisnite F5 in nato izberite gumb za enega od jezikov.
Na zaslonu Cilj se oznaka prikaže v jeziku, ki ustreza izbranemu gumbu.
Izberite puščico nazaj, da se vrnete na zaslon Vir in izberite gumb za drug jezik.
Na zaslonu Cilj se oznaka prikaže v jeziku, ki ustreza izbranemu gumbu.
Pritisnite Esc, da se vrnete v privzeti delovni prostor.
Primer po korakih 2
- Odprite aplikacijo s platnom, za katero želite uporabiti to formulo.
- Dodajte nov prazen zaslon z izbiro možnosti Nov zaslon v ukazni vrstici.
- Dodajte gumb in nastavite njegovo lastnost OnSelect na to formulo:
UpdateContext( { Name: "Lily", Score: 10 } )