הבחירה היא מה שנבחר כרגע בדף פתוח של המצגת, למשל קטע של טקסט מודגש או טבלה. במדריך הזה מוסבר איך לקבל ולהגדיר את הבחירה במצגת פעילה באמצעות Apps Script.
הבחירה היא תמונת מצב של מה שקרה כשהסקריפט התחיל. אם המשתמש הקליקים והבחירה משתנים בזמן שהסקריפט פועל, השינויים האלה לא ישתקף.
בחירות וסוג הבחירה
אפשר לקרוא את הבחירה באמצעות הכיתה Selection. בכיתה יש שיטות שונות לקבל את האובייקטים שנבחרו על סמך סוג האובייקטים שנבחרו.
המאפיין המסווג SelectionType מייצג את הסוג הספציפי של העצמים שנבחרו. לדוגמה, אם למשתמש יש
נבחר טקסט כלשהו בצורה, סוג הבחירה
להיות TEXT. במקרה כזה, אפשר לאחזר את טווח הטקסט שנבחר באמצעות
אמצעי תשלום אחד (selection.getTextRange()
).
אפשר גם לאחזר את האובייקט שמכיל את הבחירה; שממשיכים
בדוגמה שלמעלה, אפשר לאחזר את הצורה שמכילה את הטקסט שנבחר באמצעות
selection.getPageElementRange().getPageElements()[0]
באופן דומה, הדף
מכיל את הצורה המצורפת הוא הדף הפעיל הנוכחי; כדי
לאחזר את הדף הזה, יש להשתמש ב-selection.getCurrentPage()
.
בתהליך של קריאת הפריטים שנבחרו
כדי לקרוא את הטקסט שנבחר, משתמשים Presentation.getSelection() כפי שמוצג בדוגמה הבאה:
קריאת הדף הנוכחי
כדי לאחזר את הדף הנוכחי ש המשתמש צופה, יש להשתמש getSelection() וגם getCurrentPage() באופן הבא:
לתשומת ליבכם, הדף הנוכחי יכול להיות כל אחד מהסוגים הבאים:
בדף הנוכחי ניתן לבחור אובייקט אחד או יותר, ואת סוג הבחירה קובע את סוג הבחירה.
קריאת הפריטים שנבחרו על סמך סוג הבחירה
הדוגמה הבאה ממחישה איך אפשר להשתמש בסוג הבחירה כדי לקרוא את הבחירה הנוכחית בדרך שמתאימה לסוג.
הקראה של קטעי טקסט שנבחרו
אפשר לקרוא את בחירת הטקסט באמצעות המתודה Selection.getTextRange(). יש שני סוגים של בחירת טקסט:
- בחירת טווח: אם צורה מכילה את הטקסט 'שלום' ו'הוא' תואם לערך נבחר, הטווח המוחזר מכיל startIndex=0 ו-endIndex=2.
- בחירת הסמן: אם צורה מכילה את הטקסט 'Hello', והסמן נמצא אחרי האות 'H' ("H|ello"), הטווח המוחזר הוא טווח ריק עם startIndex=1 ו-endIndex=1.
מתבצע שינוי של החלק שנבחר
הסקריפט יכול לשנות את הבחירה של המשתמש. כל שינוי שבוצעה על ידי הסקריפט בבחירה של המצגת יבואו לידי ביטוי בפעולות הבחירה הבאות למשך כל ביצוע הסקריפט.
שינויי הבחירה יופיעו בדפדפן של המשתמש רק לאחר הסקריפט
הושלמו, או כשנשלחת קריאה אל Presentation.saveAndClose()
.
בחירת הדף הנוכחי
אפשר לבחור דף במצגת הפעילה כדף הנוכחי באמצעות קריאה ה-method selectAsCurrentPage(). השיטה הזו מסירה את החלק הקודם של הדף, את הדף או את בחירת הטקסט. אז באמצעות השיטה הזו בדף הנוכחי מאפשרת לך לבטל את הבחירה באפשרויות הנוכחיות הדף הזה. לדוגמה:
בחירת רכיב בדף
כדי לבחור רכיב דף בדף, משתמשים בשיטה PageElement.select(). הפעולה הזו גם מבטלת את הבחירה של רכיבי דף שנבחרו בעבר.
לדוגמה:
בחירה של מספר רכיבים בדף
כדי לצרף לבחירה רכיבי דף נוספים, משתמשים ב-method PageElement.select(false). כל רכיבי הדף חייבים להיות בדף הנוכחי.
טרנספורמציה של הבחירה
עריכות שהסקריפט מבצע יכולות להחליף את הבחירה הנוכחית, המידע שנבחר משתנה כתוצאה מהעריכה. לדוגמה:
- נניח שבחרתם את שתי הצורות A ו-B.
- בשלב הבא, הסקריפט מסיר את הצורה A.
- כתוצאה מכך, הבחירה תשתנה ביחס לעריכה כך שרק נבחרה צורה B.
הדוגמה הבאה ממחישה איך אפשר לשנות את הבחירה באמצעות מניפולציה מרכיבי הדף שנבחרו.
בחירת טקסט
אפשר לבחור טקסט בתוך צורה או בתא בטבלה באמצעות שיטת TextRange.select(). אם הטקסט נמצא בתוך צורה, גם הצורה תיבחר. אם הטקסט כלול בתא בטבלה, התא בטבלה והתא המצורף נבחרו שתיהן.
הפעולה הזו גם מגדירה את דף ההורה בתור הדף הנוכחי.
בחירת טווח בצורה
הדוגמה הבאה מראה איך לבצע בחירת טווח בתוך טקסט שכלול בצורה.
בחירת סמן בתוך צורה
בדוגמה הבאה מוסבר איך לבחור טקסט בתוך צורה באמצעות הסמן.
בחירת טווח בתא בטבלה
הדוגמה הבאה מראה איך לבצע בחירת טווח בתוך טקסט שכלול בתא בטבלה.
בחירת הסמן ב-TableCell
הדוגמה הבאה מראה איך לבצע בחירה של סמן בתוך טקסט שכלול בתא בטבלה.
טרנספורמציה של בחירה עם עריכות טקסט
הדוגמה הבאה מראה איך אפשר לשנות את הבחירה על ידי עריכת הטקסט שנבחר.
ביטול הבחירה
אין שיטות מפורשות לביטול הבחירה בטקסט או ברכיבי דף. אבל
ניתן להשיג את התוצאה באמצעות הפונקציה Page.selectAsCurrentPage()
או
pageElement.select()
אמצעי תשלום.
בחירת דף נוכחי
בדוגמה הבאה מוסבר איך לבטל את הבחירה של פריטים בדף מסוים על ידי הגדרת הדף הזה כדף הנוכחי.
בחירת רכיב דף
הדוגמה הבאה מראה איך לבטל את הבחירה באפשרויות הנוכחיות בדף על ידי בחירת רכיב דף אחד, ובכך הסרת כל שאר הפריטים מהבחירה.