कैनवास घटक गुण (प्रयोगात्मक)

कैनवास घटक निर्माताओं को घटक और घटक को होस्ट करने वाले ऐप के बीच मान या तर्क रिले करने के लिए विभिन्न प्रकार के गुण बनाने की अनुमति देते हैं. गुणधर्म इंटरैक्टिव और पुन: प्रयोज्य घटकों के निर्माण का एक अनिवार्य हिस्सा हैं।

महत्वपूर्ण

• यह एक प्रायोगिक सुविधा है.
• प्रायोगिक विशेषताएं उत्पादन उपयोग के लिए नहीं हैं और कार्यक्षमता प्रतिबंधित हो सकती हैं. यह सुविधाएँ आधिकारिक रिलीज़ से पहले उपलब्ध होती हैं ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें. अधिक जानकारी: प्रायोगिक और पूर्वावलोकन सुविधाएँ
• यह आलेख जिस व्यवहार का वर्णन करता है वह केवल तभी उपलब्ध होता है जब उन्नत घटक गुण सेटिंग्स में प्रायोगिक सुविधा > आगामी सुविधाएँ > प्रायोगिक चालू हो (डिफ़ॉल्ट रूप से बंद)।
• आपकी प्रतिक्रिया हमारे लिए बहुत मूल्यवान है - कृपया हमें प्रयोगात्मक सुविधाओं के सामुदायिक मंच पर बताएं कि आप क्या सोचते हैं। Power Apps

संपत्तियों के प्रकार

निर्माताओं के लिए चार प्रकार की संपत्तियां उपलब्ध हैं:

1. डेटा गुण: डेटा गुण डेटा से संबंधित होते हैं, जैसे रंग या पाठ मान. A डेटा संपत्ति को इनपुट या आउटपुट के रूप में सेट किया जा सकता है, जो इंगित करता है कि घटक ऐप को डेटा प्रदान करता है (आउटपुट) या ऐप घटक को डेटा प्रदान करता है (इनपुट). डेटा प्रॉपर्टीज़ ही एकमात्र ऐसी प्रॉपर्टीज़ हैं जो ऐप डेटा फ़्लो में भाग लेती हैं.
2. फ़ंक्शन गुण: फ़ंक्शन गुण तर्क से संबंधित होते हैं, जैसे विशिष्ट मापदंडों के आधार पर गणना करना या पाठ में परिवर्तन करना। A फ़ंक्शन संपत्ति को इनपुट या आउटपुट के रूप में सेट किया जा सकता है, जो यह इंगित करता है कि क्या घटक एक फ़ंक्शन प्रदान करता है जिसे ऐप कॉल कर सकता है (आउटपुट), या ऐप एक फ़ंक्शन प्रदान करता है जिसे घटक कॉल कर सकता है (इनपुट)। फ़ंक्शन गुण किसी ऐप के डेटा प्रवाह में भाग नहीं लेते हैं, और घटक या ऐप चर का उपयोग नहीं कर सकते हैं.
3. क्रिया गुण: क्रिया गुण एक प्रकार का गुण है जो तर्क से संबंधित होता है और एक आउटपुट फ़ंक्शन की तरह व्यवहार करता है। इस प्रकार, घटक में तर्क परिभाषित होता है, और वह तर्क श्रृंखलाबद्ध अभिव्यक्तियों का उपयोग कर सकता है और संग्रहों या चरों ("व्यवहार") में हेरफेर कर सकता है। उदाहरण के लिए, एक Clear() एक्शन प्रॉपर्टी कार्यक्षमता प्रदान कर सकती है जिसे ऐप घटक में कुछ मानों को साफ़ करने के लिए कॉल कर सकता है, या एक Save() एक्शन प्रॉपर्टी जो डेटा स्रोत को अपडेट करती है।
4. इवेंट गुण: इवेंट गुण, संपत्ति की एक श्रेणी है जिसमें तर्क शामिल होता है और यह एक इनपुट फ़ंक्शन के रूप में कार्य करता है। इस प्रकार, ऐप तर्क को परिभाषित करता है, जिसे घटक कॉल कर सकता है और वह तर्क श्रृंखलाबद्ध अभिव्यक्तियों का उपयोग कर सकता है और संग्रह या चर ("व्यवहार") में हेरफेर कर सकता है। आम तौर पर इन संपत्तियों के नाम किसी घटना को दर्शाते हैं जैसे OnSelect या OnChanged.

डेटा संपत्ति

डेटा प्रॉपर्टी के उपयोग की कल्पना करना आसान है। ऐप्स में मानक नियंत्रणों में आमतौर पर कई डेटा गुण होते हैं, जिनसे डिफ़ॉल्ट मान, टेक्स्ट का रंग, आकार आदि सेट किए जा सकते हैं। आइए एक सरल उदाहरण देखें जहां हम घटक के भीतर नियंत्रण के गुणों को होस्टिंग ऐप के लिए उपलब्ध कराना चाहते हैं। इस उदाहरण में, हमारे घटक का नाम Component1 है. हम अपने घटक के अंदर एक स्लाइडर नियंत्रण डालेंगे। हमारे पास उपभोग करने वाले ऐप से रंग निर्दिष्ट करने के लिए एक इनपुट प्रॉपर्टी होगी, और एक आउटपुट प्रॉपर्टी होगी जहां घटक ऐप को बता सकता है कि स्लाइडर का वर्तमान मूल्य क्या है। निम्न उदाहरण मानता है कि आपके घटक में स्लाइडर नियंत्रण है जिसका नाम Slider है।

1. घटक के गुण फलक में, नया कस्टम गुण चुनें.
2. नया कस्टम गुण फलक पर, प्रदर्शन नाम Slider Color दर्ज करें.
3. संपत्ति प्रकार का डेटा चुनें और संपत्ति परिभाषा मूल्य इनपुट चुनें.
4. अंत में, डेटा प्रकार ड्रॉपडाउन से, रंग चुनें.
5. निर्माण क्लिक करें.

इसके बाद, Slider1 स्लाइडर नियंत्रण का चयन करें. इसका ValueFill गुण ढूंढें और सूत्र पट्टी में, Component1.SliderColor दर्ज करें. Component1 हमारे घटक के नाम को संदर्भित करता है, और SliderColor उस संपत्ति का नाम है जिसे हमने पहले जोड़ा था।

अब हमारे घटक में एक SliderColor संपत्ति है जिसे उपभोग करने वाले ऐप में सेट किया जा सकता है, ताकि घटक में एक रंग पास करके स्लाइडर की ValueFill संपत्ति सेट की जा सके।

हम उपभोक्ता ऐप को स्लाइडर का मूल्य भी प्रदान करना चाहते हैं। इसे पूरा करने के लिए, हम एक आउटपुट संपत्ति जोड़ेंगे।

1. घटक के गुण फलक में, नया कस्टम गुण चुनें.
2. नई कस्टम प्रॉपर्टी पैन पर, प्रदर्शन नाम दर्ज करें Slider Value.
3. संपत्ति प्रकार का डेटा चुनें और संपत्ति परिभाषा मान आउटपुट चुनें.
4. अंत में, डेटा प्रकार ड्रॉपडाउन से, संख्या का चयन करें।
5. निर्माण क्लिक करें.

जब डेटा संपत्ति आउटपुट होती है, तो घटक उपभोग करने वाले ऐप को मान प्रदान करता है। इसके लिए सूत्र सेट करने के लिए, हमें घटक में नई SliderValue संपत्ति को स्लाइडर की मूल्य संपत्ति पर सेट करना होगा।

1. घटक के गुण फलक में, Slider Value गुण पर क्लिक करें।
2. सूत्र पट्टी में, 100 के डिफ़ॉल्ट मान को निम्न सूत्र से प्रतिस्थापित करें: Slider1.Value.

अब हमारे घटक की SliderValue संपत्ति घटक के अंदर स्लाइडर के मूल्य को प्रतिबिंबित करेगी, जिसे तब उपभोग करने वाले ऐप से पढ़ा जा सकता है।

फ़ंक्शन गुण

फ़ंक्शन गुण में एक अभिव्यक्ति होती है जो एक मान लौटाती है। आमतौर पर, फ़ंक्शन कुछ तर्क लेता है जिसका उपयोग वह लौटाए जाने वाले मान की गणना या निर्धारण करने के लिए करता है।

नोट

फ़ंक्शन गुण वर्तमान में चर या घटक मानों और गुणों तक नहीं पहुंच सकते हैं, और डेटा प्रवाह को ट्रिगर नहीं कर सकते हैं। किसी भी आवश्यक मान को तर्क के रूप में पारित किया जाना चाहिए।

एक आउटपुट फ़ंक्शन Power Apps के लिए एक कस्टम फ़ंक्शन बनाने का एक सरल तरीका है। घटक एक आउटपुट फ़ंक्शन को एक अभिव्यक्ति के साथ परिभाषित करता है जो कुछ तर्क लेता है और एक मान लौटाता है। इस फ़ंक्शन का उपयोग घटक के नाम (जैसे Component1) का उपयोग करके Component1.MyFunction(arg1, arg2) को कॉल करके ऐप में किया जा सकता है।

एक इनपुट फ़ंक्शन एक उपभोक्ता ऐप के लिए घटक को तर्क प्रदान करने का एक तरीका है, जो फ़ंक्शन पॉइंटर या कॉलबैक फ़ंक्शन के समान है। · उदाहरण के लिए, हो सकता है कि आपका घटक लोगों के नामों से निपट रहा हो और इसमें तर्कों firstname और lastname के साथ एक इनपुट फ़ंक्शन हो और एक स्ट्रिंग का सम्मान करता हो। ऐप $"{firstname} {lastname}" को वापस करने के लिए फ़ंक्शन अभिव्यक्ति को परिभाषित कर सकता है या यह $"{lastname}, {firstname}" के लिए अभिव्यक्ति को परिभाषित करना चुन सकता है। घटक केवल ऐप निर्माता द्वारा प्रदान किए गए फ़ंक्शन को कॉल कर सकता है, और लौटाए गए स्ट्रिंग का उपयोग कर सकता है।

कार्रवाई संपत्ति

क्रिया गुण, प्रकार आउटपुट के फ़ंक्शन गुणों के समान हैं, लेकिन वे साइड-इफ़ेक्ट फ़ार्मुलों और अभिव्यक्ति श्रृंखलाबद्धता की अनुमति देते हैं। किसी घटक में AddRecord नाम की एक क्रिया संपत्ति हो सकती है जो अनुप्रयोग को घटक के अंदर संग्रह में रिकॉर्ड जोड़ने की अनुमति देती है, या Reset क्रिया जो घटक के अंदर चर या संग्रह को साफ़ करती है.

डेटा प्रॉपर्टी के लिए पहले इस्तेमाल किए गए स्लाइडर उदाहरणों के उदाहरण में, हम स्लाइडर को उसके डिफ़ॉल्ट मान पर वापस सेट करने के लिए ResetValue नामक एक एक्शन प्रॉपर्टी पेश कर सकते हैं। इसके लिए हम सूत्र Reset( Slider1 ) का उपयोग कर सकते हैं। अब, ऐप में हमारे घटक के इंस्टैंस स्लाइडर को डिफ़ॉल्ट मान पर वापस सेट करने के लिए Component1.ResetValue() कॉल कर सकते हैं।

इवेंट संपत्ति

मानक नियंत्रणों में कई सामान्य ईवेंट-प्रकार के गुण होते हैं, जो प्रभावी रूप से इनपुट व्यवहार फ़ंक्शन गुण होते हैं। बटन नियंत्रण पर OnSelect इसका सबसे स्पष्ट उदाहरण है। एक घटक किसी भी संख्या में ईवेंट गुण परिभाषित कर सकता है, तथा इन ईवेंट को फ़ंक्शन की तरह कॉल कर सकता है। उदाहरण के लिए, एक घटक जिसमें बटन नियंत्रण होता है, उसमें OnButtonClicked नामक एक इवेंट गुण हो सकता है। बटन नियंत्रण के OnSelect में घटक अपनी Component1.OnButtonClicked() संपत्ति को कॉल कर सकता है। इसके बाद, उपभोक्ता ऐप इस प्रॉपर्टी के लिए अपना स्वयं का तर्क परिभाषित कर सकता है, ताकि घटक के अंदर बटन दबाने पर यह कार्य कर सके।

गुण या तर्क के लिए डिफ़ॉल्ट मान

डिफ़ॉल्ट मान किसी तर्क या गुण के लिए डिफ़ॉल्ट मान प्रदान कर सकते हैं यदि कोई भी सेट नहीं किया गया हो। कुछ प्रकार की संपत्तियों के लिए यह बात उचित नहीं है। हालाँकि, कुछ मामलों में उनका उपयोग किसी रिकॉर्ड के लिए अपेक्षित स्कीमा प्रदान करने के लिए किया जा सकता है। एक डिफ़ॉल्ट रिकॉर्ड प्रदान करके, एक रिकॉर्ड प्रकार को अपेक्षित स्कीमा के रूप में स्थापित किया जाता है।

उदाहरण के लिए, एक्शन नाम वाली संपत्ति AddRecord स्थानीय संग्रह में जोड़े जाने वाले रिकॉर्ड को स्वीकार करती है। अपेक्षित रिकॉर्ड की स्कीमा प्रदान करने के लिए, निर्माता को इस AddRecord संपत्ति के तर्क के लिए एक डिफ़ॉल्ट मान जोड़ना होगा.