फ़ंक्शन का चयन करें
इस पर लागू होता है: कैनवास ऐप्स मॉडल-संचालित ऐप्स
नियंत्रण पर एक चयनित क्रिया को सिम्युलेट करता है, जिसके कारण OnSelect सूत्र का मूल्यांकन किया जाना होता है.
वर्णन
Select फ़ंक्शन यह मानते हुए नियंत्रण पर एक चयन क्रिया सिम्युलेट करता है कि उपयोगकर्ता ने नियंत्रण पर क्लिक या टैप किया था. नतीजतन, लक्ष्य नियंत्रण पर OnSelect सूत्र का मूल्यांकन किया जाता है.
पैरेंट नियंत्रण पर चयन क्रिया प्रोपेगेट करने के लिए Select का उपयोग करें. इस प्रकार का प्रोपेगेशन डिफ़ॉल्ट व्यवहार होता है, उदाहरण के लिए गैलरी. डिफ़ॉल्ट रूप से, गैलरी नियंत्रण में किसी भी नियंत्रण के OnSelect गुण को Select (Parent) पर सेट किया जाता है. इस तरह, आप गैलरी नियंत्रण के OnSelect गुण के मान को खुद सेट कर सकते हैं और सूत्र का इस पर ध्यान दिए बिना मूल्यांकन किया जाएगा कि गैलरी में उपयोगकर्ता कहाँ क्लिक या टैप कर सकता है.
यदि आप चाहते हैं कि गैलरी में एक या अधिक नियंत्रण गैलरी से अलग क्रियाएँ करें, तो उन नियंत्रणों के OnSelect गुण को डिफ़ॉल्ट मान के अलावा किसी अन्य चीज़ पर सेट करें. यदि आप वही क्रिया निष्पादित करना चाहते हैं, जो गैलरी खुद करती है, तो आप गैलरी में अधिकांश नियंत्रणों के OnSelect गुणों के लिए डिफ़ॉल्ट मानों को छोड़ सकते हैं.
आगे संसाधन के लिए, Select लक्ष्य OnSelect को कतारबद्ध करता है, जो वर्तमान सूत्र का मूल्यांकन समाप्त होने के बाद हो सकता है. Select के कारण लक्ष्य OnSelect का तुरंत मूल्यांकन नहीं किया जाता है, ना ही Select OnSelect का मूल्यांकन समाप्त होने की प्रतीक्षा करता है.
आप स्क्रीन पर Select का उपयोग नहीं कर सकते.
आप केवल उन नियंत्रणों के साथ Select का उपयोग कर सकते हैं, जिनके पास OnSelect गुण है.
आप केवल व्यवहार सूत्र में Select का उपयोग कर सकते हैं.
एक नियंत्रण अन्य नियंत्रणो के माध्यम से खुद को प्रत्यक्ष या अप्रत्यक्ष रूप से सीधे चुन नहीं सकता.
गैलरी के साथ भी Select फ़ंक्शन का उपयोग किया जा सकता है. उदाहरण के लिए, इसका उपयोग गैलरी में चयन की जाने वाली पंक्ति या स्तंभ को निर्दिष्ट करने के लिए और गैलरी की उस पंक्ति या स्तंभ में चयन किए जाने वाले नियंत्रण को निर्दिष्ट करने के लिए किया जा सकता है. जब आप कोई पंक्ति या स्तंभ चुनते हैं, तो गैलरी का चयन बदल जाता है और गैलरी नियंत्रण के OnSelect सूत्र का मूल्यांकन किया जाता है. यदि पंक्ति या स्तंभ के भीतर एक नियंत्रण प्रदान किया जाता है, तो चाइल्ड नियंत्रण के लिए OnSelect सूत्र का मूल्यांकन किया जाएगा.
सिंटैक्स
Select( नियंत्रण )
- नियंत्रण – आवश्यक. उपयोगकर्ता की ओर से चयन किए जाने वाला नियंत्रण.
Select( नियंत्रण, पंक्ति या स्तंभ, चाइल्ड नियंत्रण )
- नियंत्रण – आवश्यक. उपयोगकर्ता की ओर से चयन किए जाने वाला नियंत्रण.
- पंक्ति या स्तंभ – आवश्यक नहीं. गैलरी नियंत्रण में उपयोगकर्ता की ओर चुने जाने वाली पंक्ति या स्तंभ (1 से शुरू) की संख्या.
- चाइल्ड नियंत्रण - आवश्यक नहीं. 'नियंत्रण' पैरामीटर में चुने जाने वाले पहचाने गए नियंत्रण का चाइल्ड नियंत्रण.
उदाहरण
बटन
Select(button1)
गैलरी
Select(Gallery1, 1)
Gallery1 में पंक्ति 1 या स्तंभ 1 का चयन करके उपयोगकर्ता को सिम्युलेट करता है.
गैलरी
Select(Gallery1, 1, ChildControl1)
Gallery1 में पंक्ति 1 या स्तंभ 1 में ChildConttrol का चयन करके उपयोगकर्ता को सिम्युलेट करता है.
मूल उपयोग
एक बटन नियंत्रण जोड़ें और यदि उसका नाम Button1 से भिन्न है, तो उसे यह नाम दें.
Button1 के OnSelect गुण को इस सूत्र पर सेट करें:
Notify( "Hello World" )
उसी स्क्रीन पर एक दूसरा बटन नियंत्रण जोड़ें और उसके OnSelect गुण को इस सूत्र पर सेट करें:
Select( Button1 )
Alt कुंजी को दबाए रखते हुए, दूसरा बटन चुनें.
आपके ऐप के शीर्ष पर एक सूचना दिखाई देती है. Button1 का OnSelect गुण को इस सूचना को जनरेट करता है.
गैलरी नियंत्रण
एक ऐसा अनुलंब गैलरी नियंत्रण जोड़ें, जिसमें अन्य नियंत्रण शामिल हों.
गैलरी के OnSelect गुण को इस सूत्र पर सेट करें:
Notify( "गैलरी चुनी गई" )
Alt कुंजी को दबाए रखते हुए, गैलरी की पृष्ठभूमि या गैलरी में किसी भी नियंत्रण पर क्लिक करें या टैप करें.
सभी क्रिया ऐप के शीर्ष पर गैलरी चुनी गई सूचना दिखाएंगी.
गैलरी के OnSelect गुण का उस डिफ़ॉल्ट क्रिया को निर्दिष्ट करने के लिए उपयोग करें, जो उपयोगकर्ता द्वारा गैलरी में किसी आइटम पर क्लिक या टैप करने पर की जाएगी.
छवि नियंत्रण के OnSelect गुण को इस सूत्र पर सेट करें:
Notify( "छवि चुनी गई", सफल )
Alt कुंजी को दबाए रखते हुए, गैलरी के विभिन्न तत्वों पर क्लिक करें या टैप करें.
जब आप छवि को छोड़कर गैलरी में किसी भी नियंत्रण पर क्लिक या टैप करते हैं, तो चुनी हुई गैलरी पहले की तरह दिखाई देती है. जब आप छवि पर क्लिक या टैप करते हैं, तो छवि चुनी गई दिखाई देती है.
ऐसी क्रियाएँ करने के लिए गैलरी के अलग-अलग नियंत्रणों का उपयोग करें, जो गैलरी की डिफ़ॉल्ट क्रिया से भिन्न हैं.
उसी स्क्रीन पर एक बटन नियंत्रण जोड़ें और उसके OnSelect गुण को इस सूत्र पर सेट करें:
Select( Gallery1,2,Image1 )
Alt कुंजी को दबाए रखते हुए बटन चुनें.
आपके ऐप के शीर्ष पर छवि चुनी गई सूचना दिखाई देती है. बटन क्लिक, गैलरी की पंक्ति 2 में छवि के चयन को सिम्युलेट करता है.