EditForm, NewForm, , SubmitFormResetForm, , और कार्य ViewForm

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

प्रपत्र संपादित करें नियंत्रण में कोई आइटम देखें, संपादित करें या बनाएँ, सामग्री सहेजें, और नियंत्रणों को रीसेट करें.

अवलोकन

ये फ़ंक्शन प्रपत्र संपादित करें नियंत्रण की स्थिति को परिवर्तित करते हैं. प्रपत्र नियंत्रण निम्न से किसी एक मोड में हो सकता है:

मोड	वर्णन
फॉर्ममोड.संपादित करें	प्रपत्र एक मौजूदा रिकॉर्ड द्वारा पोप्युलेटेड है, और उपयोगकर्ता फ़ील्ड के मानों को संशोधित कर सकता है. पूर्ण हो जाने के बाद, उपयोगकर्ता रिकॉर्ड पर परिवर्तनों को सहेज सकता है.
फॉर्ममोड.नया	प्रपत्र डिफ़ॉल्ट मानों के साथ पोप्युलेट होता है और उपयोगकर्ता फ़ील्ड के मानों को संशोधित कर सकता है. पूर्ण हो जाने के बाद, उपयोगकर्ता डेटा स्रोत पर रिकॉर्ड जोड़ सकता है.
फॉर्ममोड.दृश्य	प्रपत्र मौजूदा रिकॉर्ड द्वारा पोप्युलेटेड है, परंतु उपयोगकर्ता फ़ील्ड के मानों को संशोधित नहीं कर सकता.

वर्णन

इन फ़ंक्शनों को अक्सर OnSelect फ़ॉर्मूले या Button या Image नियंत्रण से लागू किया जाता है, ताकि उपयोगकर्ता संपादन सहेज सके, संपादन छोड़ सके या रिकॉर्ड बना सके. आप एक पूर्ण समाधान बनाने के लिए नियंत्रणों और इन फ़ंक्शन का एक साथ उपयोग कर सकते हैं.

ये फ़ंक्शन कोई मान नहीं देते.

आप इन फ़ंक्शन का उपयोग केवल व्यवहार सूत्रों में कर सकते हैं.

SubmitForm

डेटा स्रोत के लिए प्रपत्र नियंत्रण में किसी भी परिवर्तन को सहेजने के लिए बटन नियंत्रण के OnSelect गुण में फ़ंक्शन का SubmitForm उपयोग करें।

कोई भी परिवर्तन सबमिट करने से पहले, यह फ़ंक्शन किसी भी ऐसे फ़ील्ड, जो आवश्यक के रूप में चिह्नित है या जिसके मान पर एक या अधिक प्रतिबंध हैं, की सत्यापन समस्याओं के लिए जाँच करता है. यह व्यवहार Validate फ़ंक्शन के व्यवहार से मेल खाता है.

SubmitFormप्रपत्र की मान्य संपत्ति की भी जाँच करता है, जो प्रपत्र नियंत्रण में मौजूद कार्ड नियंत्रणों के सभी मान्य गुणों का एकत्रीकरण है. यदि कोई समस्या होती है, तो डेटा सबमिट नहीं होता, और प्रपत्र नियंत्रण के Error और ErrorKind गुण तदनुसार सेट किए जाते हैं.

यदि सत्यापन पास हो जाता है, SubmitForm तो डेटा स्रोत में परिवर्तन सबमिट करता है।

• यदि सफल हो, तो फ़ॉर्म का OnSuccess व्यवहार चलता है, और Error और ErrorKind गुण साफ़ हो जाते हैं। यदि प्रपत्र FormMode.New मोड में था, तो वह FormMode.Edit मोड पर लौट जाता है.
• असफल होने पर, फ़ॉर्म का OnFailure व्यवहार चलता है, और Error और ErrorKind गुण तदनुसार सेट किए जाते हैं। प्रपत्र का मोड अपरिवर्तित है.

EditForm

EditForm फ़ंक्शन प्रपत्र नियंत्रण के मोड को FormMode.Edit में बदल देता है। इस मोड में, प्रपत्र नियंत्रण के Item गुण की सामग्री का उपयोग प्रपत्र को पॉप्युलेट करने में किया जाता है. यदि प्रपत्र इस मोड में होने पर फ़ंक्शन चलता है, तो SubmitForm कोई रिकॉर्ड परिवर्तित हो जाता है, नहीं बनाया जाता है. FormMode.Edit फ़ॉर्म नियंत्रण के लिए डिफ़ॉल्ट है.

नोट

जब फॉर्म संपादन मोड में होता है और आइटम शून्य होता है, तो डेटा कार्ड गुणों का मूल्यांकन नहीं किया जाता है और डिफ़ॉल्ट मान लौटाए जाते हैं।

NewForm

NewForm फ़ंक्शन प्रपत्र नियंत्रण के मोड को FormMode.New में परिवर्तित करता है। इस मोड में, प्रपत्र नियंत्रण के Item गुण की सामग्री को अनदेखा कर दिया जाता है, और प्रपत्र के DataSource गुण के डिफ़ॉल्ट मान प्रपत्र को पॉप्युलेट करते हैं. यदि प्रपत्र इस मोड में होने पर फ़ंक्शन चलता है, तो SubmitForm एक रिकॉर्ड बनाया जाता है, परिवर्तित नहीं किया जाता है.

ResetForm

ResetForm फ़ंक्शन किसी प्रपत्र की सामग्री को उनके प्रारंभिक मानों पर रीसेट करता है, इससे पहले कि उपयोगकर्ता कोई परिवर्तन करे। यदि प्रपत्र FormMode.New मोड में है, तो प्रपत्र FormMode.Edit मोड पर रीसेट हो जाता है. प्रपत्र नियंत्रण का OnReset व्यवहार भी चलता है. आप Reset फ़ंक्शन द्वारा भी व्यक्तिगत नियंत्रणों को रीसेट कर सकते हैं, परंतु केवल प्रपत्र के भीतर प्रपत्र में.

ViewForm

ViewForm फ़ंक्शन प्रपत्र नियंत्रण के मोड को FormMode.View में परिवर्तित करता है। इस मोड में, प्रपत्र नियंत्रण के Item गुण की सामग्री का उपयोग प्रपत्र को पॉप्युलेट करने में किया जाता है. SubmitForm इस मोड में होने पर और फ़ंक्शंस ResetForm का कोई प्रभाव नहीं पड़ता है।

DisplayMode गुण

वर्तमान मोड को मोड गुण के माध्यम से पढ़ा जा सकता है. यह मोड DisplayMode गुण का मान भी निर्धारित करता है, जिसका उपयोग प्रपत्र नियंत्रण के भीतर डेटा कार्ड और नियंत्रणों द्वारा किया जा सकता है. अक्सर, डेटा कार्ड का DisplayMode गुण Parent.DisplayMode (प्रपत्र के संदर्भ में) पर सेट किया जाएगा, जैसा कि नियंत्रण का DisplayMode गुण (डेटा कार्ड के संदर्भ में) करता है:

मोड	DisplayMode	वर्णन
फॉर्ममोड.संपादित करें	प्रदर्शन मोड.संपादित करें	डेटा कार्ड और नियंत्रण संपादन योग्य हैं, रिकॉर्ड में परिवर्तन स्वीकार करने के लिए तैयार हैं.
फॉर्ममोड.नया	प्रदर्शन मोड.संपादित करें	डेटा कार्ड और नियंत्रण संपादन योग्य हैं, एक नया रिकॉर्ड स्वीकार करने के लिए तैयार हैं.
फॉर्ममोड.दृश्य	डिस्प्लेमोड.दृश्य	डेटा कार्ड और नियंत्रण संपादन योग्य नहीं हैं और देखने के लिए अनुकूलित हैं.

सिंटैक्स

SubmitForm( फॉर्म का नाम )

• FormName - आवश्यक. डेटा स्रोत पर सबमिट करने के लिए प्रपत्र नियंत्रण.

EditForm( फॉर्म का नाम )

• FormName - आवश्यक. FormMode.Edit मोड पर स्विच करने के लिए प्रपत्र नियंत्रण.

NewForm( फॉर्म का नाम )

• FormName - आवश्यक. FormMode.New मोड पर स्विच करने के लिए प्रपत्र नियंत्रण.

ResetForm( फॉर्म का नाम )

• FormName - आवश्यक. प्रारंभिक मानों पर रीसेट करने के लिए प्रपत्र नियंत्रण. साथ ही, प्रपत्र को FormMode.New मोड से FormMode.Edit मोड पर स्विच करता है.

ViewForm( फॉर्म का नाम )

• FormName - आवश्यक. FormMode.View मोड पर स्विच करने के लिए प्रपत्र नियंत्रण.

उदाहरण

पूर्ण उदाहरणों के लिए डेटा प्रपत्रों को समझें देखें.

1. एक बटन नियंत्रण जोड़ें, इसके Text गुण को सहेजें दर्शाने के लिए सेट करें, और इसके OnSelect गुण को इस सूत्र पर सेट करें:

   SubmitForm( EditForm )

2. प्रपत्र नियंत्रण के OnFailure गुण को रिक्त पर सेट करें और इसके onSuccess गुण को इस सूत्र पर सेट करें:

   पीछे()

3. एक लेबल नियंत्रण ErrorText नाम रखें, और इसके Text गुण को इस सूत्र पर सेट करें:

   EditForm. चूक

   जब उपयोगकर्ता सहेजें बटन चयन करता है, तो प्रपत्र नियंत्रण में कोई भी बदलाव अंतर्निहित डेटा स्रोत को सबमिट कर दिए जाते हैं.

   • यदि सबमिशन सफल हो जाता है, तो कोई भी परिवर्तन सहेजा जाता है या, यदि प्रपत्र नियंत्रण नया मोड में है, तो एक रिकॉर्ड बनता है. ErrorText रिक्त है और पिछली स्क्रीन पुनः प्रकट होती है।
   • यदि सबमिशन विफल हो जाता है, तो ErrorText एक उपयोगकर्ता अनुकूल त्रुटि संदेश दिखाता है, और वर्तमान स्क्रीन दृश्यमान बनी रहती है ताकि उपयोगकर्ता समस्या को ठीक कर पुनः प्रयास कर सके.

4. एक बटन नियंत्रण जोड़ें, इसके Text गुण को रद्द करें दर्शाने के लिए सेट करें, और इसके OnSelect गुण को इस सूत्र पर सेट करें:

   ResetForm( EditForm ); वापस()

   जब उपयोगकर्ता रद्द करें बटन चयन करता है, तो प्रपत्र नियंत्रण में मान उस मान पर रीसेट होते हैं जो उपयोगकर्ता के संपादन शुरू करने से पहले थे, पिछली स्क्रीन पुनः दिखाई देती है, और प्रपत्र नियंत्रण यदि नया मोड में था, तो वापस संपादित करें मोड पर आ जाता है.

5. एक बटन नियंत्रण जोड़ें, इसके Text गुण को नया दर्शाने के लिए सेट करें, और इसके OnSelect गुण को इस सूत्र पर सेट करें:

   NewForm( EditForm ); नेविगेट (एडिटस्क्रीन, कोई नहीं)

   जब उपयोगकर्ता नया बटन चयन करता है, तो प्रपत्र नियंत्रण नया मोड पर स्विच करता है, प्रपत्र नियंत्रण के डेटा स्रोत के डिफ़ॉल्ट मान उस नियंत्रण को पॉप्युलेट करते हैं, और प्रपत्र नियंत्रण वाली स्क्रीन दिखाई देती है. जब फ़ंक्शन चलता है SubmitForm , तो अपडेट करने के बजाय एक रिकॉर्ड बनाया जाता है।