בחר פונקציה

חל על: יישומי בד ציור יישומים מונחי דגמים

מדמה פעולת בחירה בפקד, הגורמת להערכה של נוסחת OnSelect.

תיאור

הפונקציה Select מדמה פעולת בחירה בפקד כפי שהיה מתבצע לו המשתמש לחץ או הקיש על הפקד. כתוצאה מכך, נוסחת OnSelect בפקד היעד מוערכת.

השתמש ב- Select כדי להפיץ פעולת בחירה לפקד אב. סוג זה של הפצה הוא אופן הפעולה של ברירת המחדל, לדוגמה, בגלריות. כברירת מחדל, המאפיין OnSelect של פקד כלשהו בפקד Gallery‎ מוגדר לבחירה (אב). כך, באפשרותך להגדיר את הערך של המאפיין OnSelect של פקד ה- Gallery עצמו, ונוסחה זו תוערך ללא קשר למיקום בגלריה שבו משתמש עשוי ללחוץ או להקיש.

אם ברצונך שפקד אחד או יותר בגלריה יבצעו פעולות שונות מהגלריה עצמה, הגדר את המאפיין OnSelect עבור פקדים אלה למשהו אחר מלבד ערך ברירת המחדל. באפשרותך להשאיר את ערכי ברירת המחדל עבור מאפייני OnSelect של רוב הפקדים בגלריה אם ברצונך שיבצעו את אותן פעולות כשל הגלריה עצמה.

הפונקציה Select מציבה בתור את OnSelect של היעד עבור עיבוד במועד מאוחר יותר, מה שעשוי להתרחש לאחר שהנוסחה הנוכחית סיימה את ההערכה שלה. Select אינה גורמת ל- OnSelect של היעד להערכה מיידית, ו- Select גם אינה ממתינה עבור OnSelect כדי שיסיים את ההערכה.

אין באפשרותך להשתמש ב- Select בין מסכים.

באפשרותך להשתמש ב- Select רק עם פקדים הכוללים מאפיין OnSelect.

באפשרותך להשתמש בפונקציה Select רק בנוסחאות של אופן פעולה.

פקד לא יכול לבחור בעצמו ישירות או בעקיפין דרך פקדים אחרים.

ניתן להשתמש בפונקציה Select גם עם גלריה. לדוגמה, ניתן להשתמש בה כדי לציין את השורה או העמודה שיש לבחור בהן בגלריה ואת הפקד שיש לבחור בו בתוך אותה שורה או עמודה של הגלריה. כשבוחרים שורה או עמודה, בחירת הגלריה משתנה והנוסחה OnSelect בפקד ה- Gallery מוערכת. אם פקד בשורה או בעמודה מסופק, הנוסחה OnSelect עבור פקד הצאצא תוערך.

תחביר

Select( Control )

• Control – נדרש. הפקד לבחירה מטעם המשתמש.

Select( Control, Row or column, Child Control )

• Control – נדרש. הפקד לבחירה מטעם המשתמש.
• Row or column – לא נדרש. מספר השורה או העמודה (המתחילה ב- 1) בפקד gallery כדי לבחור בשם המשתמש.
• Child Control - לא נדרש. פקד הצאצא של הפקד המזוהה בפרמטר 'control' שיש לבחור.

דוגמאות

• לחצן

  Select(button1)

• גלריה

  Select(Gallery1, 1)

  מדמה משתמש שבוחר בשורה 1 או בעמודה 1 בגלריה 1.

• גלריה

  Select(Gallery1, 1, ChildControl1)

  מדמה משתמש שבוחר בפקד צאצא 1 בשורה 1 או בעמודה 1 של גלריה 1.

שימוש בסיסי

1. הוסף פקד Button ושנה את שמו ל- Button1 אם יש לו שם אחר.

2. הגדר את המאפיין OnSelect של Button1 לנוסחה זו:

   Notify( "Hello World" )

3. באותו מסך, הוסף פקד Button‎ שני, והגדר את מאפיין OnSelect לנוסחה זו:

   Select( Button1 )

4. תוך כדי לחיצה על מקש Alt, בחר בלחצן השני.

   מופיעה הודעה לאורך החלק העליון של היישום שלך. המאפיין OnSelect של Button1 יצר הודעה זו.

   

פקד Gallery

1. הוסף Gallery‎ אנכי המכיל פקדים אחרים.

   

2. הגדר את המאפיין OnSelect של הגלריה לנוסחה זו:

   Notify( "Gallery Selected" )

3. תוך כדי לחיצה ממושכת על מקש Alt, לחץ או הקש על רקע הגלריה או פקד כלשהו בגלריה.

   כל הפעולות יציגו את ההודעה הגלריה נבחרה בראש היישום.

   השתמש במאפיין OnSelect של הגלריה כדי לציין את פעולת ברירת המחדל שיש לנקוט כאשר המשתמש לוחץ או מקיש על פריט בגלריה.

4. הגדר את המאפיין OnSelect של פקד התמונה לנוסחה זו:

   Notify( "Image Selected", Success )

5. תוך כדי לחיצה ממושכת על מקש Alt, לחץ או הקש על הרכיבים השונים של הגלריה.

   כשאתה לוחץ או מקיש על פקד כלשהו בגלריה, למעט התמונה, ההודעה הגלריה נבחרה מופיעה כמו קודם. כשאתה לוחץ או מקיש על התמונה, ההודעה התמונה נבחרה מופיעה.

   השתמש בפקדים נפרדים בגלריה כדי לנקוט פעולות השונות מפעולת ברירת המחדל של הגלריה.

   

6. באותו מסך, הוסף פקד Button‎, והגדר את מאפיין OnSelect לנוסחה זו:

   Select( Gallery1,2,Image1 )

7. תוך כדי לחיצה על מקש Alt, בחר את הלחצן.

   מופיעה הודעת תמונה נבחרה לאורך החלק העליון של היישום שלך. לחיצת הלחצן המדמה בחירה בתמונה בשורה 2 של הגלריה.