הפונקציה 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 )
- Control – נדרש. הפקד לאיפוס.
דוגמה
- הוסף פקד Text input במסך. כברירת מחדל, שמו יהיה TextInput1 ומאפיין Default שלו יוגדר ל-"Text input".
- הקלד ערך חדש בתיבת הטקסט.
- הוסף פקד Button במסך.
- הגדר את המאפיין OnSelect של הלחצן ל- Reset( TextInput1 ).
- בחר בלחצן. זה ניתן לביצוע גם בעת העריכה על-ידי בחירה לעבר קצוות הפקד.
- תוכן תיבת הטקסט יחזור לערך מאפיין Default.