הפונקציות Back ו- Navigate
משנה את המסך המוצג.
מבט כולל
רוב היישומים מכילים מסכים מרובים. השתמש בפונקציה Back ו- Navigate כדי לשנות את המסך המוצג. לדוגמה, הגדר את המאפיין OnSelect של לחצן לנוסחה הכוללת פונקציית Navigate אם ברצונך להציג מסך שונה כאשר משתמש בוחר בלחצן זה. בנוסחה זו, באפשרותך לציין מעבר חזותי, כגון עמעום, כדי לשלוט באופן שבו מסך אחד משתנה למסך אחר.
Back ו- Navigate משנות רק את המסך המוצג. מסכים שאינם מוצגים כעת ממשיכים לפעול מאחורי הקלעים. באפשרותך לבנות נוסחאות המתייחסות למאפיינים של פקדים במסכים אחרים. לדוגמה, משתמש יכול לשנות את הערך של מחוון במסך אחד, לנווט אל מסך אחר המשתמש בערך זה בנוסחה ולקבוע כיצד הוא משפיע על מה שקורה במסך החדש. המשתמש יכול לאחר מכן לנווט בחזרה אל המסך המקורי ולאשר שהמחוון שמר על ערכו.
משתני הקשר נשמרים גם כאשר משתמש מנווט בין מסכים. באפשרותך להשתמש ב- Navigate כדי להגדיר משתנה הקשר אחד או יותר עבור המסך שהנוסחה תציג, וזו הדרך היחידה להגדיר משתנה הקשר מחוץ למסך. באפשרותך להשתמש בגישה זו כדי להעביר פרמטרים למסך. אם השתמשת בכלי תיכנות אחר, גישה זו דומה להעברת פרמטרים להליכים.
השתמש במאפיין StartScreen של האובייקט יישום כדי לשלוט במסך הראשון שיוצג.
באפשרותך להשתמש בכל אחת מהפונקציות רק בתוך נוסחה של אופן פעולה.
נווט
חל על:
יישומי בד ציור יישומים מונחי דגמים
בארגומנט הראשון, ציין את שם המסך שיש להציג.
בארגומנט השני, ציין כיצד המסך הישן משתנה למסך החדש:
| Transition Argument | תיאור | הדגמה |
|---|---|---|
| ScreenTransition.Cover | המסך החדש מחליק לתצוגה, כשהוא זז מימין לשמאל, כדי לכסות את המסך הנוכחי. |  |
| ScreenTransition.CoverRight | המסך החדש מחליק לתצוגה, כשהוא זז משמאל לימין, כדי לכסות את המסך הנוכחי. |  |
| ScreenTransition.Fade | המסך הנוכחי מתעמעם וחושף את המסך החדש. |  |
| ScreenTransition.None (ברירת מחדל) | המסך החדש מחליף במהירות את המסך הנוכחי. |  |
| ScreenTransition.UnCover | המסך הנוכחי מחליק מחוץ לתצוגה, כשהוא זז מימין לשמאל, כדי לחשוף את המסך החדש. |  |
| ScreenTransition.UnCoverRight | המסך הנוכחי מחליק מחוץ לתצוגה, כשהוא זז משמאל לימין, כדי לחשוף את המסך החדש. |  |
באפשרותך להשתמש בפונקציה Navigate כדי ליצור או לעדכן משתני הקשר של המסך החדש. כארגומנט שלישי אופציונלי, העבר רשומה המכילה את שם משתנה ההקשר כשם עמודה ואת הערך החדש עבור משתנה ההקשר. רשומה זו זהה לרשומה שבה אתה משתמש עם הפונקציה UpdateContext.
הגדר את המאפיין OnHidden של המסך הישן, את המאפיין OnVisible של המסך החדש או את שניהם כדי לבצע שינויים נוספים במהלך המעבר. המאפיין App.ActiveScreen יתעדכן כדי לשקף את השינוי.
הפונקציה Navigate מחזירה בדרך כלל true אבל תחזיר false אם היא נתקלת בשגיאה.
משתני הקשר עבור ניווט מוסברים במאמר ניווט בין מסכים.
Back
חל על: יישומי בד ציור
הפונקציה Back חוזרת למסך שהוצג לאחרונה.
עבור כל קריאה ל- Navigate, היישום עוקב אחר המסך שהופיע ואחר המעבר. באפשרותך להשתמש בקריאות רצופות ל- Back כדי לחזור כל הדרך למסך שהופיע כאשר המשתמש הפעיל את היישום.
כאשר הפונקציה Back פועלת, המעבר ההפוך משמש כברירת מחדל. לדוגמה, אם הופיע מסך דרך המעבר CoverRight, הפונקציה Back משתמשת ב- UnCover (משמאל) כדי לחזור. Fade ו- None הם הפוכים זה לזה. העבר ארגומנט אופציונלי אל Back כדי לכפות מעבר ספציפי.
Back מחזירה בדרך כלל true אבל מחזירה false אם המשתמש לא ניווט אל מסך אחר מאז שהפעיל את היישום.
תחביר
Back( [ Transition ] )
- Transition - אופציונלי. המעבר החזותי שיש להשתמש בו בין המסך הנוכחי למסך הקודם. עיין ברשימת הערכים החוקיים של ארגומנט זה שמופיעה מוקדם יותר במאמר זה. כברירת מחדל, המעבר שדרכו מסך חוזר הוא הופכי למעבר שדרכו הוא הופיע.
Navigate( Screen [, Transition [, UpdateContextRecord ] ] )
- Screen - נדרש. המסך שיש להציג. במקום מסך, אתה יכול גם להשתמש בפקד שנמצא במסך שאליו ברצונך לנווט.
- Transition - אופציונלי. המעבר החזותי שיש להשתמש בו בין המסך הנוכחי למסך הבא. עיין ברשימת הערכים החוקיים של ארגומנט זה שמופיעה מוקדם יותר במאמר זה. ערך ברירת המחדל הוא None.
- UpdateContextRecord - אופציונלי. רשומה המכילה את השם של עמודה אחת וערך אחד לפחות עבור כל עמודה. רשומה זו מעדכנת את משתני ההקשר של המסך החדש כפי שהיה קורה אם הייתה עוברת אל הפונקציה UpdateContext.
דוגמאות
| נוסחה | תיאור | תוצאה |
|---|---|---|
| Navigate( Details ) | מציגה את המסך פרטים ללא מעבר או שינוי בערך עבור משתנה הקשר. | המסך פרטים מופיע במהירות. |
| Navigate( Details, ScreenTransition.Fade ) | מציגה את המסך פרטים עם מעבר עמעום. שום ערך של משתנה הקשר לא השתנה. | המסך הנוכחי מתעמעם כדי להציג את המסך פרטים. |
| Navigate( Details, ScreenTransition.Fade, { ID: 12 } ) | מציג את המסך פרטים עם מעבר עמעום ומעדכן את הערך של משתנה ההקשר מזהה ל- 12. | המסך הנוכחי מתעמעם כדי להציג את המסך פרטים, ומשתנה ההקשר מזהה במסך זה מוגדר ל- 12. |
| Navigate( Details, ScreenTransition.Fade, { ID: 12 , Shade: Color.Red } ) | מציגה את המסך פרטים עם מעבר עמעום. מעדכן את הערך של משתנה ההקשר מזהה ל- 12, ומעדכן את הערך של משתנה ההקשר הצללה ל- Color.Red. | המסך הנוכחי מתעמעם כדי להציג את המסך פרטים. משתנה ההקשר מזהה במסך פרטים מוגדר ל- 12, ומשתנה ההקשר הצללה מוגדר ל- Color.Red. אם תגדיר את המאפיין Fill של הפקד במסך פרטים לערך הצללה, הפקד יוצג כאדום. |
| Back() | מציג את המסך הקודם עם מעבר החזרה של ברירת המחדל. | מציג את המסך הקודם דרך המעבר ההפוך של המעבר שדרכו הופיע המסך הנוכחי. |
| Back( ScreenTransition.Cover ) | מציג את המסך הקודם עם מעבר כיסוי. | מציג את המסך הקודם דרך המעבר כיסוי, ללא קשר למעבר שדרכו הופיע המסך הנוכחי. |
שלב אחר שלב
צור יישום ריק.
הוסף אליו מסך שני.
היישום מכיל שני מסכים ריקים: Screen1 ו- Screen2.
הגדר את המאפיין Fill של Screen2 לערך
Gray.ב- Screen2, הוסף לחצן והגדר את מאפיין OnSelect שלו לנוסחה זו:
Navigate( Screen1, ScreenTransition.Cover )תוך כדי לחיצה על מקש Alt, בחר את הלחצן.
Screen1 מופיע עם רקע לבן דרך מעבר המכסה מצד שמאל.
ב- Screen1, הוסף לחצן והגדר את מאפיין OnSelect שלו לנוסחה זו:
Back()תוך כדי לחיצה על מקש Alt, בחר את הלחצן.
המסך השני מופיע עם רקע אפור דרך מעבר שחושף מימין (ההפך של כיסוי).
בחר בלחצן בכל מסך שוב ושוב כדי לחזור אחורה וקדימה.