बैक और नेविगेट फ़ंक्शन

प्रदर्शित की जाने वाली स्क्रीन को बदलता है.

ओवरव्यू

ज्यादातर ऐप्स में कई स्क्रीन होती हैं. प्रदर्शित की जाने वाली स्क्रीन बदलने के लिए Back और Navigate फ़ंक्शन का उपयोग करें. उदाहरण के लिए, यदि आप चाहते हैं कि जब उपयोगकर्ता बटन चुनें, तो एक अलग स्क्रीन दिखाई जाए, तो इसके लिए उस बटन के OnSelect गुण को ऐसे सूत्र पर सेट करें, जिसमें Navigate फ़ंक्शन हो. उस सूत्र में, आप एक विज़ुअल ट्रांज़िशन निर्दिष्ट कर सकते हैं, जैसे कि Fade, जो यह नियंत्रित करे कि कैसे एक स्क्रीन दूसरी स्क्रीन में बदली जाए.

Back और Navigate केवल प्रदर्शित की जाने वाली स्क्रीन को बदलते हैं. वे स्क्रीन, जो वर्तमान में प्रदर्शित नहीं की जा रही हैं, उनका पृष्ठभूमि में संचालन जारी रहेगा. आप अन्य स्क्रीन पर नियंत्रण के गुणों को संदर्भित करने वाले सूत्र बना सकते हैं. उदाहरण के लिए, उपयोगकर्ता स्क्रीन पर स्लाइडर के मान को बदल सकता है, ऐसी अलग स्क्रीन पर नेविगेट कर सकता है, जो सूत्र में उस मान का उपयोग करती है और यह निर्धारित करती है कि नई स्क्रीन में क्या होता है, उसको वह कैसे प्रभावित करती है. उपयोगकर्ता फिर से मूल स्क्रीन पर वापस आ सकता है और पुष्टि कर सकता है कि स्लाइडर ने अपना मान कायम रखा.

जब कोई उपयोगकर्ता स्क्रीन के बीच नेविगेट करता है, तो संदर्भ वेरिएबल भी संरक्षित किए जाते हैं. आप उस स्क्रीन के लिए एक या अधिक संदर्भ चर सेट करने के हेतु Navigate का उपयोग कर सकते हैं, जिन्हें सूत्र प्रदर्शित करेगा, जो स्क्रीन के बाहर संदर्भ सेट करने का एकमात्र तरीका है. आप स्क्रीन पर पैरामीटर पास करने के लिए इस दृष्टिकोण का उपयोग कर सकते हैं. यदि आपने किसी अन्य प्रोग्रामिंग टूल का उपयोग किया है, तो यह दृष्टिकोण पैरामीटर को प्रक्रियाओं से पास करने के समान है.

दिखने वाली पहली स्क्रीन को नियंत्रित करने के लिए ऐप ऑब्जेक्ट की StartScreen संपत्ति का उपयोग करें.

आप व्यवहार सूत्र के अंदर केवल किसी एक फ़ंक्शन का उपयोग कर सकते हैं.

इन पर लागू होता है: कैनवास ऐप्स मॉडल-संचालित ऐप्स

पहले तर्क में, प्रदर्शित की जाने वाली स्क्रीन का नाम निर्दिष्ट करें.

दूसरे तर्क में, निर्दिष्ट करें कि पुरानी स्क्रीन नई स्क्रीन में कैसे बदले:

ट्रांज़िशन तर्क वर्णन प्रदर्शन
ScreenTransition.Cover नई स्क्रीन, वर्तमान स्क्रीन को कवर करने के लिए, दाएं से बाएं की ओर चलती हुई दृ्श्य में आ जाती है. स्क्रीन ट्रांज़िशन एनीमेशन को कवर करता है.
ScreenTransition.CoverRight नई स्क्रीन, वर्तमान स्क्रीन को कवर करने के लिए, बाएं से दाएँ की ओर चलती हुई दृश्य में आ जाती है. स्क्रीन ट्रांज़िशन दाएँ एनीमेशन को कवर करता है.
ScreenTransition.Fade वर्तमान स्क्रीन नई स्क्रीन को प्रकट करने के लिए फ़ेड हो जाती है. स्क्रीन ट्रांज़िशन एनीमेशन को फ़ेड करता है.
ScreenTransition.None (डिफ़ॉल्ट) नई स्क्रीन वर्तमान स्क्रीन को तुरंत बदल देती है. स्क्रीन किसी एनीमेशन को ट्रांज़िशन नहीं करती.
ScreenTransition.UnCover वर्तमान स्क्रीन, नई स्क्रीन को दिखाने के लिए, दाएँ से बाएं की ओर चलती हुई हट जाती है. स्क्रीन ट्रांज़िशन एनीमेशन दिखाता है.
ScreenTransition.UnCoverRight वर्तमान स्क्रीन, नई स्क्रीन को दिखाने के लिए, बाएं से दाएँ की ओर चलती हुई हट जाती है. स्क्रीन ट्रांज़िशन दाएँ एनीमेशन को दिखाता है.

आप नई स्क्रीन के संदर्भ चर बनाने या अद्यतन करने के लिए Navigate का उपयोग कर सकते हैं. वैकल्पिक तीसरे तर्क के रूप में, एक ऐसा रिकॉर्ड पास करें, जिसमें संदर्भ-चर का नाम स्तंभ नाम के रूप में हो और संदर्भ चर के लिए नया मान हो. यह रिकॉर्ड वही रिकॉर्ड है, जिसका उपयोग आप UpdateContext फ़ंक्शन के साथ करते हैं.

पुरानी स्क्रीन का OnHidden गुण, नई स्क्रीन का OnVisible गुण या दोनों सेट करें, ताकि ट्रांज़िशन के दौरान अतिरिक्त परिवर्तन किए जा सकें. परिवर्तन को दर्शाने के लिए, App.ActiveScreen गुण अद्यतन किया जाएगा.

Navigate आम तौर पर सही दिखाता है, लेकिन त्रुटि मिलने पर गलत दिखाता है.

स्क्रीन के बीच नेविगेट करें आलेख में नेविगेशन के लिए संदर्भ चरों के बारे में बताया गया है.

पीछे जाएँ

इन पर लागू होता है: कैनवास ऐप्स

Back फ़ंक्शन उस स्क्रीन पर लौटता है, जिसे हाल ही में प्रदर्शित किया गया था.

प्रत्येक Navigate कॉल के लिए, ऐप दिखाई देने वाली स्क्रीन और ट्रांज़िशन को ट्रैक करता है. आप उस स्क्रीन पर लौटने के लिए, जो उपयोगकर्ता द्वारा ऐप प्रारंभ करने पर दिखाई देती है, अनुक्रमिक रूप से Back कॉल का उपयोग कर सकते हैं.

Back फ़ंक्शन के चलने पर, डिफ़ॉल्ट रूप से इनवर्स ट्रांज़िशन का उपयोग किया जाता है. उदाहरण के लिए, यदि स्क्रीन CoverRight ट्रांज़िशन के माध्यम से दिखाई देती है, तो Back लौटने के लिए UnCover (जो बाईं ओर है) का उपयोग करता है. Fade और None अपने स्वयं के इनवर्स हैं. किसी विशिष्ट ट्रांज़िशन को बाध्य करने के लिए Back पर एक वैकल्पिक तर्क पास करें.

Back आम तौर पर सही दिखाता है, लेकिन यदि ऐप के शुरू करने के बाद से उपयोगकर्ता अन्य स्क्रीन पर नहीं गया है, तो गलत दिखाता है.

सिंटैक्स

Back( [ Transition ] )

  • Transition - वैकल्पिक. वर्तमान स्क्रीन और पिछली स्क्रीन के बीच उपयोग किया जाने वाला विज़ुअल ट्रांज़िशन. इस तर्क के लिए, इस आलेख में पहले दी गई मान्य मानों की सूची देखें. डिफ़ॉल्ट रूप से, वह ट्रांज़िशन, जिसके माध्यम से स्क्रीन लौटती है, वह उस ट्रांज़िशन के इनवर्स होता है, जिसके माध्यम से वह दिखाई देती है.

Navigate( Screen [, Transition [, UpdateContextRecord ] ] )

  • स्क्रीन - आवश्यक. प्रदर्शित की जाने वाली स्क्रीन. स्क्रीन के स्थान पर, आप उस नियंत्रण का भी उपयोग कर सकते हैं जो उस स्क्रीन पर है जिस पर आप नेविगेट करना चाहते हैं।
  • Transition - वैकल्पिक. वर्तमान स्क्रीन और अगली स्क्रीन के बीच उपयोग किया जाने वाला विज़ुअल ट्रांज़िशन. इस तर्क के लिए, इस आलेख में पहले दी गई मान्य मानों की सूची देखें. डिफ़ॉल्ट मान None है.
  • UpdateContextRecord - वैकल्पिक. एक रिकॉर्ड, जिसमें कम से कम एक स्तंभ का नाम और प्रत्येक स्तंभ के लिए एक मान होता है. यह रिकॉर्ड यह मानते हुए नई स्क्रीन के संदर्भ चर अद्यतन करता है कि उन्हें UpdateContext फ़ंक्शन पर पास किया गया है.

उदाहरण

सूत्र वर्णन परिणाम
Navigate( Details ) संदर्भ चर के लिए बिना कोई ट्रांज़िशन या बिना मान में परिवर्तन वाली Details स्क्रीन प्रदर्शित करता है. Details स्क्रीन तुरंत दिखाई देती है.
Navigate( Details, ScreenTransition.Fade ) Fade ट्रांज़िशन वाली Details स्क्रीन दिखाता है. संदर्भ चर का कोई मान नहीं बदला गया. वर्तमान स्क्रीन Details स्क्रीन को प्रकट करने के लिए फ़ेड हो जाती है.
Navigate( Details, ScreenTransition.Fade, { ID: 12 } ) Fade ट्रांज़िशन वाली Details स्क्रीन दिखाता है और ID संदर्भ चर के मान को 12 में अद्यतन करता है. वर्तमान स्क्रीन Details स्क्रीन को दिखाने के लिए फ़ेड हो जाती है और उस स्क्रीन की संदर्भ चर ID को 12 पर सेट किया जाता है.
Navigate( Details, ScreenTransition.Fade, { ID: 12 , Shade: Color.Red } ) Fade ट्रांज़िशन वाली Details स्क्रीन दिखाता है. ID संदर्भ चर के मान को 12 में अद्यतन करता है और Shade संदर्भ चर के मान को Color.Red में अद्यतन करता है. वर्तमान स्क्रीन Details स्क्रीन को प्रकट करने के लिए फ़ेड हो जाती है. Details स्क्रीन पर संदर्भ चर ID को 12 पर सेट किया जाता है और संदर्भ चर Shade को Color.Red पर सेट किया जाता है. यदि आप Details स्क्रीन पर नियंत्रण के भरण गुण को Shade पर सेट करते हैं, तो वह नियंत्रण लाल रंग में प्रदर्शित होगा.
Back() डिफ़ॉल्ट वापसी ट्रांज़िशन के साथ पिछली स्क्रीन को प्रदर्शित करता है. उस ट्रांज़िशन के इनवर्स ट्रांज़िशन में माध्यम से पिछली स्क्रीन को प्रदर्शित करता है, जिसके माध्यम से वर्तमान स्क्रीन प्रदर्शित हुई है.
Back( ScreenTransition.Cover ) Cover ट्रांज़िशन वाली पिछली स्क्रीन को प्रदर्शित करता है. उस ट्रांज़िशन पर ध्यान दिए बिना, जिसके माध्यम से वर्तमान स्क्रीन प्रदर्शित हुई है, Cover ट्रांज़िशन में माध्यम से पिछली स्क्रीन को प्रदर्शित करता है.

चरण-दर-चरण

  1. एक रिक्त ऐप बनाएँ.

  2. उसमें दूसरी स्क्रीन जोड़ें.

    ऐप में दो रिक्त स्क्रीन शामिल हैं: Screen1 और Screen2.

  3. Screen2 के भरण गुण को मान Gray पर सेट करें.

  4. Screen2 पर, एक बटन जोड़ें और उसके OnSelect गुण को इस सूत्र पर सेट करें:

    Navigate( Screen1, ScreenTransition.Cover )
    
  5. Alt कुंजी को दबाए रखते हुए बटन चुनें.

    Screen1 ट्रांज़िशन के माध्यम से सफेद पृष्ठभूमि के साथ दिखाई देती है, जो बाईं ओर को कवर करती है.

  6. Screen1 पर, एक बटन जोड़ें और उसके OnSelect गुण को इस सूत्र पर सेट करें:

    Back()
    
  7. Alt कुंजी को दबाए रखते हुए बटन चुनें.

    दूसरी स्क्रीन ऐसे ट्रांज़िशन के माध्यम से ग्रे पृष्ठभूमि में दिखाई देती है, जो दाईं ओर को अनकवर (Cover का इनवर्स) करती है.

  8. प्रत्येक स्क्रीन पर बटन को बार-बार चुनें, ताकि आगे-पीछे बाउंस किया जा सके.

भी देखें

संदर्भ चर का उपयोग करना