UpdateContext funkcija

  • Raksts

Attiecas uz: Audekla programmām

Izveido vai atjaunina pašreizējā ekrāna konteksta mainīgos.

Pārskats

Izmantojiet UpdateContext funkciju, lai izveidotu konteksta mainīgo, kas īslaicīgi ietver kādu informācijas vienību, piemēram, reižu skaitu, kad lietotājs ir atlasījis pogu, vai datu operācijas rezultātu.

Konteksta mainīgie tiek ietverti ekrānā, kas nozīmē, ka nevarat izveidot formulu, kura atsaucas uz konteksta mainīgo citā ekrānā. Ja izmantojāt citu programmēšanas rīku, jūs varat domāt par konteksta mainīgo kā līdzīgu lokālajam mainīgajam. Izmantojiet Set funkciju, lai strādātu ar globālajiem mainīgajiem, kas ir pieejami visā programmā.

Power Apps balstās uz formulām, kas tiek automātiski pārrēķinātas, lietotājam mijiedarbojoties ar programmu. Konteksta mainīgie nepiedāvā šo priekšrocību, un to lietojums var apgrūtināt jūsu programmas izveidi un izpratni. Pirms konteksta mainīgā lietošanas pārskatiet sadaļu darbs ar mainīgajiem.

Apraksts

Lai izveidotu vai atjauninātu konteksta mainīgo, padodiet vienu ierakstu funkcijai UpdateContext. Katrā ierakstā norādiet kolonnas nosaukumu, kas definē vai atbilst mainīgā nosaukumam, un vērtību, uz kuru vēlaties šo mainīgo iestatīt.

  • Ja norādāt iepriekš definētā mainīgā nosaukumu, funkcija UpdateContext iestata mainīgā vērtību uz jūsu norādītu vērtību.
  • Ja norādāt vēl neeksistējoša mainīgā nosaukumu, funkcija UpdateContext izveido mainīgo ar šo nosaukumu un iestata tā mainīgo uz jūsu norādītu vērtību.
  • Ja iepriekš definējāt mainīgo, bet nenorādījāt to šajā konkrētajā UpdateContext formulā, tā vērtība paliek tāda pati.

Konteksta mainīgos netieši izveido, izmantojot UpdateContext vai Navigate funkciju. Nav nepieciešama tieša deklarācija. Noņemot visas UpdateContext un Navigate atsauces uz konteksta mainīgo, šis konteksta mainīgais vairs nepastāvēs. Lai notīrītu mainīgo, Iestatiet to vērtību uz Blank funkcijas rezultātu.

Mainīgos vērtības, definīcijas un izmantojumu Mainīgo skatā var skatīt autorēšanas vides izvēlnē Fails.

Atsaucu uz konteksta mainīgo formulā sniedz, izmantojot mainīgā kolonnas nosaukumu. Piemēram, UpdateContext( { ShowLogo: true } ) izveido konteksta mainīgo ar nosaukumu ShowLogo un iestata tā vērtību uz true. Varat pēc tam izmantot šī konteksta mainīgā vērtību, izmantojot ShowLogo nosaukumu formulā. Varat rakstīt ShowLogo kā formulu attēla vadīklas rekvizītam Redzams un rādīt vai slēpt šo vadīklu, pamatojoties uz to, vai konteksta mainīgā vērtība ir true vai false.

Kā redzams piemēros tālāk šajā tēmā, konteksta mainīgie var saturēt dažāda veida informāciju, tostarp:

  • vienu vērtību
  • ierakstu
  • tabulu
  • objekta atsauci
  • jebkuru rezultātu no formulas

Konteksta mainīgais saglabā savu vērtību, līdz tiek aizvērta programma. Ja definējat konteksta mainīgo un iestatāt tā vērtību noteiktā ekrānā, šī informācija paliek neskarta pat, ja lietotājs pārslēdzas uz citu ekrānu. Pēc programmas aizvēršanas konteksta mainīgā vērtība tiks zaudēta un to ir jāizveido no jauna, kad programma tiek vēlreiz ielādēta.

Katrs konteksta mainīgais is ietverts ekrānā. Ja vēlaties definēt konteksta mainīgo vienā ekrānā un modificēt šo konteksta mainīgo no cita ekrāna, ir jāveido formula, kas balstās funkcijā Navigate. Vai izmantojiet globālu mainīgo.

UpdateContext nav atgrieztas vērtības, un to var izmantot tikai uzvedības formulā.

Sintakse

UpdateContext( UpdateRecord )

  • UpdateRecord — Obligāti. Ieraksts, kas satur vismaz vienas kolonnas nosaukumu un šīs kolonnas vērtību. Konteksta mainīgo izveido vai atjaunina katrai kolonnai un vērtībai, ko norādāt.

UpdateContext( { ContextVariable1: Value1 [, ContextVariable2: Value2 [, ... ] ] } )

  • ContextVariable1 — Obligāti. Nosaukums konteksta mainīgajam, kas ir jāizveido vai jāatjaunina.
  • Value1 — Obligāti. Vērtība, kuru piešķir konteksta mainīgajam.
  • ContextVariable2: Value2, ... — Neobligāti. Papildu konteksta mainīgie, kurus jāizveido vai jāatjaunina, un to vērtības.

Piemēri

Formula Apraksts Rezultāts
UpdateContext( { Skaitītājs:1 } ) Izveido vai modificē konteksta mainīgo Skaitītājs, iestatot tā vērtību 1. Skaitītājam ir vērtība 1. Varat atsaukties uz šo mainīgo izmantojot nosaukumu Skaitītājs formulā.
UpdateContext( { Skaitītājs:2 } ) Iestata konteksta mainīgā Skaitītājs vērtību no iepriekšējā piemēra uz 2. Skaitītājam ir vērtība 2.
UpdateContext( { Name: "Lily", Score: 10 } ) Izveido vai modificē konteksta mainīgo Nosaukums un Rezultāts, iestatot to vērtības attiecīgi uz Lily un 10. Nosaukum ir vērtība Lily un Rezultātam ir vērtība 10.
UpdateContext( {Persona: { Vārds: "Milton", Adrese: "1 MainSt" } }) Izveido vai modificē konteksta mainīgo Persona, iestatot tā vērtību uz ierakstu. Ierakstā ir divas kolonnas ar nosaukumu Vārds un Adrese. Kolonnas Vārds vērtība ir Milton, bet kolonnas Adrese vērtība ir 1 Main St. Personai ir ieraksta {Vārds: "Milton", Adrese: "1MainSt" } }.

Atsaucieties uz šo ierakstu kā veselu ar nosaukumu Persona vai atsaucieties uz atsevišķu šī ieraksta kolonnu ar Person.Name vai Person.Address.
UpdateContext( {Persona: Patch( Person, {Adrese: "2MainSt" }) }) Darbojas ar Patch funkciju, lai atjauninātu Personas konteksta mainīgo, iestatot Adreses kolonnas vērtību uz 2 Main St. Personai tagad ir ieraksta { Vārds:"Milton", Adrese: "2 Main St } }.

1. pakāpenisku darbību piemērs

  1. Nosauciet noklusējuma ekrānu par Avots, pievienojiet citu ekrānu un nosauciet to par Mērķis.

  2. Avota ekrānā pievienojiet divas pogas un iestatiet to Teksta rekvizītus tā, lai vienā būtu teikts Angļu, bet otrā Spāņu.

  3. Iestatiet pogas Angļu rekvizītu OnSelect uz šo izteiksmi:
    Navigate(Target, ScreenTransition.Fade, {Language:"English"})

  4. Iestatiet pogas Spāņu rekvizītu OnSelect uz šo izteiksmi:
    Navigate(Target, ScreenTransition.Fade, {Language:"Spanish"})

  5. Mērķa ekrānā pievienojiet etiķeti un iestatiet tās Teksta rekvizītu uz šo izteiksmi:
    If(Language="English", "Hello!", "Hola!")

  6. Mērķa ekrānā cilnē Ievietot atlasiet Formas un pēc tam atlasiet atpakaļvērsto bultiņu.

  7. Iestatiet atpakaļvērstās bultiņas OnSelect rekvizītu uz šo formulu:
    Navigate(Source, ScreenTransition.Fade)

  8. No Avota ekrāna nospiediet F5 un pēc tam atlasiet pogu katrai no valodām.

    Mērķa ekrānā tiek parādīta etiķete valodā, kas atbilst jūsu atlasītajai pogai.

  9. Atlasiet atpakaļvērsto bultiņu, lai atgrieztos Avota ekrānā un pēc tam atlasiet pogu citai valodai.

    Mērķa ekrānā tiek parādīta etiķete valodā, kas atbilst jūsu atlasītajai pogai.

  10. Nospiediet Esc, lai atgrieztos noklusējuma darbvietā.

2. pakāpenisku darbību piemērs

  1. Atveriet to pamatnes programmu, kurā vēlaties izmantot šo formulu.
  2. Komandjoslā atlasiet Jauns ekrāns, lai atlasītu jaunu tukšu ekrānu.
  3. Pievienojiet pogu un iestatiet tās rekvizītu OnSelect uz tālāk norādīto formulu:
    UpdateContext( { Name: "Lily", Score: 10 } )