EditForm, NewForm, SubmitForm, ResetForm, और ViewForm फ़ंक्शन

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

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

अवलोकन

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

वर्णन

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

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

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

प्रपत्र सबमिट करें

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

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

सबमिटफ़ॉर्म फ़ॉर्म के वैध गुण की भी जाँच करता है, जो कि फ़ॉर्म नियंत्रण में शामिल सभी वैध कार्ड नियंत्रणों के गुणों का एकत्रीकरण है। यदि कोई समस्या होती है, तो डेटा सबमिट नहीं होता, और प्रपत्र नियंत्रण के 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 गुण (डेटा कार्ड के संदर्भ में) करता है:

सिंटैक्स

फॉर्म सबमिट करें( फॉर्मनाम )

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

फॉर्म संपादित करें( फॉर्मनाम )

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

नयाफ़ॉर्म( फ़ॉर्मनाम )

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

रीसेटफॉर्म( फॉर्मनाम )

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

व्यूफॉर्म( फॉर्मनाम )

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

उदाहरण

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

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

   फॉर्म सबमिट करें( फॉर्म संपादित करें )

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

   पीछे()

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

   संपादनफ़ॉर्म.त्रुटि

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

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

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

   रीसेटफॉर्म(एडिटफॉर्म); बैक()

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

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

   नयाफ़ॉर्म( संपादनफ़ॉर्म ); नेविगेट( संपादनस्क्रीन, कोई नहीं )

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