एडिटफॉर्म, न्यूफॉर्म, सबमिटफॉर्म, रीसेटफॉर्म और व्यूफॉर्म फ़ंक्शन

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

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

अवलोकन

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

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

वर्णन

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

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

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

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

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

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

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

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

• सफल होने पर, फ़ॉर्म का OnSuccess व्यवहार चलता है, और त्रुटि और ErrorKind गुण साफ़ हो गए हैं। यदि प्रपत्र FormMode.New मोड में था, तो वह FormMode.Edit मोड पर लौट जाता है.
• असफल होने पर, फ़ॉर्म का OnFairure व्यवहार चलता है, और त्रुटि और 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	वर्णन
FormMode.Edit	DisplayMode.Edit	डेटा कार्ड और नियंत्रण संपादन योग्य हैं, रिकॉर्ड में परिवर्तन स्वीकार करने के लिए तैयार हैं.
FormMode.New	DisplayMode.Edit	डेटा कार्ड और नियंत्रण संपादन योग्य हैं, एक नया रिकॉर्ड स्वीकार करने के लिए तैयार हैं.
FormMode.View	DisplayMode.View	डेटा कार्ड और नियंत्रण संपादन योग्य नहीं हैं और देखने के लिए अनुकूलित हैं.

सिंटैक्स

SubmitForm( FormName )

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

EditForm( FormName )

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

NewForm( FormName )

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

ResetForm( FormName )

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

ViewForm( FormName )

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

उदाहरण

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

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

   SubmitForm( EditForm )

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

   Back()

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

   EditForm.Error

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

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

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

   ResetForm( EditForm ); Back()

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

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

   NewForm( EditForm ); Navigate( EditScreen, None )

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