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