Бөлісу құралы:

UpdateContext функциясы

  • Мақала

Мыналарға қолданылады: Canvas қолданбалары

Ағымдағы экранның мәтінмәндік айнымалыларын жасайды немесе жаңартады.

Шолу

UpdateContext функцисын пайдаланушы түймешікті қанша рет таңдағаны немесе деректермен әрекеттің нәтижесі сияқты ақпарат бөлігін уақытша сақтайтын мәтінмәндік айнымалыны жасау үшін пайдаланыңыз.

Мәтінмәндік айнымалылардың ауқымы экранда болады, яғни басқа экранда мәтінмәндік айнымалыға сілтеме жасайтын формуланы жасай алмайсыз. Егер сіз басқа бағдарламалау құралын пайдаланған болсаңыз, онда мәтінмәндік айнымалы жергілікті айнымалыға ұқсас деп ойлай аласыз. Set функциясын бүкіл бағдарламада қолжетімді глобалдық айнымалылармен жұмыс істеу үшін пайдаланыңыз.

Power Apps пайдаланушы бағдарламамен өзара әрекеттескен кезде автоматты түрде қайта есептелетін формулаларға негізделген. Мәтінмәндік айнымалылар бұл артықшылықты ұсынбайды және бағдарламаңызды жасау және түсінуді қиындатуы мүмкін. Мәтінмәндік айнымалыны пайдалану алдында айнымалылармен жұмыс істеу бөлімін қарап шығыңыз.

Сипаттама

Мәтінмәндік айнымалыны жасау немесе жаңарту үшін бір жазбаныUpdateContext функциясына өткізіңіз. Әр жазбада айнымалы атауын анықтайтын немесе оған сәйкес келетін баған атауын және сол айнымалыны орнатқыңыз келетін мәнді көрсетіңіз.

  • Егер сіз бұрын анықталған айнымалы атауын көрсетсеңіз, UpdateContext айнымалы мәнін сіз көрсеткен мәнге орнатады.
  • Егер сіз әлі жоқ айнымалы атауын көрсетсеңіз, UpdateContextфункциясы сол атпен айнымалы жасайды және сол айнымалының мәнін сіз көрсеткен мәнге орнатады.
  • Егер сіз бұрын айнымалы мәнін анықтасаңыз, бірақ оны нақ осы UpdateContext формуласында көрсетпесеңі, оның мәні өзгеріссіз қалады.

Мәтінмәндік айнымалылар UpdateContext немесе Navigate функциясын пайдалана отырып жанама түрде жасалады. Ашық жариялау қажет емес. Егер сіз мәтінмәндік айнымалыға UpdateContext және Navigate сілтемелерінің барлығын жойсаңыз, сол мәтінмәндік айнымалы жоқ болып кетеді. Айнымалыны тазалау үшін мәнін Blank функциясының нәтижесіне орнатыңыз.

Айнымалылардың мәндерін, анықтамаларын және қолданыстарын жасау ортасындағы "Файл" мәзіріндегі "Айнымалылар" көрініснде көре аласыз.

Формуладағы мәнмәтіндік айнымалыға айнымалының баған атауын пайдалана отырып сілтеме жасай аласыз. Мысалы, UpdateContext( { ShowLogo: true } ) формуласы ShowLogo атты мәтінмәндік айнымалыны жасайды және мәнін true деп орнатады. Содан кейін осы мәтінмәндік айнымалының мәнін формулада ShowLogo атауы бойынша пайдалана аласыз. Сіз ShowLogo мәтінмәндік айнымалысын кескінді басқару элементінің Visible сипаты үшін формула ретінде жаза аласыз және мәтінмәндік айнымалының мәні true немесе false екенінің негізінде басқару элементін көрсете немесе жасыра аласыз.

Осы тақырыптағы кейінірек келетін мысалдарда көрсетілгендей, мәтінмәндік айнымалылар ақпараттың бірнеше түрін сақтай алады, соның ішінде мыналарды:

  • бір мән
  • жазба
  • кесте
  • нысанға сілтеме
  • формуладағы кез келген нәтиже

Мәтінмәндік айнымалы бағдарлама жабылғанға дейін мәнін сақтайды. Егер сіз мәтінмәндік айнымалыны анықтасаңыз және оның мәнін белгілі бір экранда орнатсаңыз, тіпті пайдаланушы басқа экранға ауысқан кезде де бұл ақпарат өзгеріссіз қалады. Бағдарлама жабылғаннан кейін мәтінмәндік айнымалының мәні жоғалады және бағдарлама қайтадан жүктелген кезде оны қайта жасау керек.

Әр мәнмәтіндік айнымалының ауқымы экранға орнатылады. Егер бір экранда мәтінмән айнымалысын анықтап, сол айнымалыны басқа экраннан өзгерткіңіз келсе, онда сізге Navigate функциясына негізделген формуланы жасау керек. Я болмаса глобалдық айнымалыны пайдаланыңыз.

UpdateContext функциясының қайтарылатын мәні жоқ және оны тек мінез-құлық формуласы ішінде пайдалануға болады.

Синтаксис

UpdateContext( UpdateRecord )

  • UpdateRecord – Міндетті. Кемінде бір баған атауын және сол баған мәнін қамтитын жазба. Мәтінмәндік айнымалы сіз көрсеткен әр баған мен мән үшін жасалады немесе жаңартылады.

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

  • ContextVariable1 - Міндетті. Жасайтын немесе жаңартатын мәтінмәндік айнымалының атауы.
  • Value1 - Міндетті. Мәтінмәндік айнымалыға тағайындалатын мән.
  • ContextVariable2: Value2, ... - Міндетті емес. Жасайтын немесе жаңартатын қосымша мәтінмәндік айнымалылар және олардың мәндері.

Мысалдар

Формула Сипаттама Нәтиже
UpdateContext( { Counter: 1 } ) Мәнін 1 деп орнатып, Counter мәтінмәндік айнымалысын жасайды немесе өзгертеді. Counter айнымалысында 1 мәні бар. Сіз бұл айнымалыға формулада Counter атауын пайдалана отырып сілтеме жасай аласыз.
UpdateContext( { Counter: 2 } ) Алдыңғы мысалдағы Counter мәтінмәндік айнымалысының мәнін 2 деп орнатады. Counter айнымалысында 2 мәні бар.
UpdateContext( { Name: "Lily", Score: 10 } ) Name және Score мәтінмәндік айнымалыларын жасайды немесе өзгертеді, олардың мәндерін сәйкесінше Lily және 10 деп орнатады. Name айнымалысының мәні Lily, ал Score айнымалысының мәні 10.
UpdateContext( { Person: { Name: "Milton", Address: "1 Main St" } } ) Мәнін жазбаға орнатып, Person мәтінмәндік айнымалысын жасайды немесе өзгертеді. Жазба Name және Address атты екі бағанды қамтиды. Name бағанының атауы — Milton, ал Address бағанының мәні — 1 Main St. Person глобалдық айнымалысында { Name: "Milton", Address: "1 Main St" } } жазбасының мәні бар.

Осы жазбаға тұтастай Person атауымен сілтеме жасаңыз немесе осы жазбаның жеке бағанына Person.Name немесе Person.Address арқылы сілтеме жасаңыз.
UpdateContext( { Person: Patch( Person, {Address: "2 Main St" } ) } ) Address бағанының мәнін 2 Main St деп орнату арқылы Person мәтінмәндік айнымалысын жаңарту үшін Patch функциясымен бірге жұмыс істейді. Енді Person глобалдық айнымалысында { Name: "Milton", Address: "2 Main St" } } жазбасының мәні бар.

1 қадамдық мысал

  1. Әдепкі экранды Көз деп атаңыз, тағы бір экран қосыңыз және оны Мақсат деп атаңыз.

  2. Көз экранында екі түймешікті қосып, олардың Мәтін сипаттарын English дегенге және екіншісін Spanish дегенге орнатыңыз.

  3. English түймешігінің OnSelect сипатын мына өрнекке орнатыңыз:
    Navigate(Target, ScreenTransition.Fade, {Language:"English"})

  4. Spanish түймешігінің OnSelect сипатын мына өрнекке орнатыңыз:
    Navigate(Target, ScreenTransition.Fade, {Language:"Spanish"})

  5. Мақсат экранында белгі қосыңыз және оның Мәтін сипатын мына өрнекке қосыңыз:
    If(Language="English", "Hello!", "Hola!")

  6. Мақсат экранында Кірістіру қойыншасында Пішіндер опциясын таңдаңыз, содан кейін артқа көрсеткісін таңдаңыз.

  7. Артқа көрсеткісінің OnSelect сипатын мына формулаға орнатыңыз:
    Navigate(Source, ScreenTransition.Fade)

  8. Көз экранында F5 пернесін басыңыз, содан кейін тілдердің біреуі үшін түймешікті таңдаңыз.

    Мақсат экранында белгі таңдалған түймешікке сәйкес келетін тілде көрінеді.

  9. Көз экранына оралу үшін артқа көрсеткісін таңдаңыз, содан кейін екінші тіл үшін түймешікті таңдаңыз.

    Мақсат экранында белгі таңдалған түймешікке сәйкес келетін тілде көрінеді.

  10. Әдепкі жұмыс кеңістігіне оралу үшін Esc пернесін басыңыз.

2 қадамдық мысал

  1. Осы формуланы қолдану керек кенеп бағдарламасын ашыңыз.
  2. Пәрмендер жолағынан Жаңа экран параметрін таңдау арқылы жаңа бос экран қосыңыз.
  3. Түймені қосыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:
    UpdateContext( { Name: "Lily", Score: 10 } )