الدالة Reset

ينطبق على: تطبيقات اللوحة التطبيقات المستندة إلى النموذج

إعادة تعيين عنصر تحكم إلى قيمته الافتراضية، مع تجاهل أي تغييرات على المستخدم.

‏‏الوصف

تقوم وظيفة Reset بإعادة تعيين عنصر تحكم إلى قيمة الخاصية Default الخاصة به. ويتم تجاهل أي تغييرات من المستخدم.

لا يمكنك إعادة تعيين عناصر التحكم الموجودة في عنصر تحكم Gallery أو Edit form من خارج عناصر التحكم هذه. يمكنك إعادة تعيين عناصر التحكم من الصيغ على عناصر التحكم داخل نفس المعرض أو النموذج. يمكنك أيضًا إعادة تعيين جميع عناصر التحكم داخل نموذج باستخدام وظيفة ResetForm.

يُعد استخدام وظيفة Reset بديلاً لتبديل خاصية إعادة التعيين الخاصة بعناصر تحكم الإدخال وتكون مفضلة عمومًا. قد تكون خاصية Reset اختيارًا أفضل إذا كانت هناك حاجة إلى إعادة تعيين العديد من عناصر التحكم معًا من صيغ متعددة. يمكن القيام بتبديل خاصية Reset من عنصر تحكم Button باستخدام الصيغة Reset = Button.Pressed أو من متغير باستخدام Reset = MyVar وتبديل MyVar بالصيغة Button.OnSelect = Set( MyVar, true ); Set( MyVar, false ).

كما تتم إعادة تعيين عناصر تحكم الإدخال عند تغير الخاصية Default.

لا تحتوي وظيفة Reset على أي قيمة إرجاع، ويمكنك استخدامها فقط في صيغ السلوك.

بناء الجملة

Reset( Control )

• عنصر تحكم – مطلوب. عنصر التحكم المراد إعادة تعيينه.

مثال

1. أدخل عنصر تحكم Text input على شاشة. افتراضيا، سيكون اسمه TextInput1 وسوف يتم تعيين الخاصية Default الخاصة به إلى "Text input".
2. اكتب قيمة جديدة في مربع النص.
3. أدرج عنصر تحكم Button على الشاشة.
4. قم بتعيين خاصية OnSelect الخاصة بالزر إلى Reset( TextInput1 ).
5. حدد الزر. يمكن القيام بذلك حتى عند التأليف عن طريق التحديد باتجاه نهايات عنصر التحكم.
6. ستقوم محتويات مربع النص بالإرجاع إلى قيمة الخاصية Default.