הבחירה של המשתמש במצגת הפעילה.
var selection = SlidesApp.getActivePresentation().getSelection(); var currentPage = selection.getCurrentPage(); var selectionType = selection.getSelectionType(); }
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
getCurrentPage() | Page | מחזירה את Page או null הפעילים הנוכחיים אם אין דף פעיל. |
getPageElementRange() | PageElementRange | הפונקציה מחזירה את האוסף PageElementRange של מכונות PageElement
שנבחרו או של null אם לא נבחרו PageElement מכונות. |
getPageRange() | PageRange | הפונקציה מחזירה את PageRange אוסף של מופעים של Page ב-flimstrip
שנבחרו או מסוג null אם הבחירה היא לא מסוג SelectionType.PAGE . |
getSelectionType() | SelectionType | הפונקציה מחזירה את הערך SelectionType . |
getTableCellRange() | TableCellRange | הפונקציה מחזירה את האוסף TableCellRange של מכונות TableCell שנבחרו
או את האוסף null אם לא נבחרו TableCell מכונות. |
getTextRange() | TextRange | הפונקציה מחזירה את הערך TextRange שנבחר או את הערך null אם הבחירה אינה מסוג
SelectionType.TEXT . |
תיעוד מפורט
getCurrentPage()
מחזירה את Page
או null
הפעילים הנוכחיים אם אין דף פעיל.
var selection = SlidesApp.getActivePresentation().getSelection(); var currentPage = selection.getCurrentPage(); if (currentPage != null) { Logger.log('Selected current active page ID: ' + currentPage.getObjectId()); }
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementRange()
הפונקציה מחזירה את האוסף PageElementRange
של מכונות PageElement
שנבחרו או של null
אם לא נבחרו PageElement
מכונות.
var selection = SlidesApp.getActivePresentation().getSelection(); var selectionType = selection.getSelectionType(); if (selectionType == SlidesApp.SelectionType.PAGE_ELEMENT) { var currentPage = selection.getCurrentPage(); var pageElements = selection.getPageElementRange().getPageElements(); Logger.log('Number of page elements selected: ' + pageElements.length); }
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageRange()
הפונקציה מחזירה את PageRange
אוסף של מופעים של Page
ב-flimstrip
שנבחרו או מסוג null
אם הבחירה היא לא מסוג SelectionType.PAGE
.
var selection = SlidesApp.getActivePresentation().getSelection(); var selectionType = selection.getSelectionType(); if (selectionType == SlidesApp.SelectionType.PAGE) { var pageRange = selection.getPageRange(); Logger.log('Number of pages in the flimstrip selected: ' + pageRange.getPages().length); } }
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSelectionType()
הפונקציה מחזירה את הערך SelectionType
.
var selection = SlidesApp.getActivePresentation().getSelection(); var selectionType = selection.getSelectionType(); if (selectionType == SlidesApp.SelectionType.CURRENT_PAGE) { var currentPage = selection.getCurrentPage(); Logger.log('Selected current active page ID: ' + currentPage.getObjectId()); }
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTableCellRange()
הפונקציה מחזירה את האוסף TableCellRange
של מכונות TableCell
שנבחרו
או את האוסף null
אם לא נבחרו TableCell
מכונות.
var selection = SlidesApp.getActivePresentation().getSelection(); var selectionType = selection.getSelectionType(); if (selectionType == SlidesApp.SelectionType.TABLE_CELL) { var currentPage = selection.getCurrentPage(); var tableCells = selection.getTableCellRange().getTableCells(); var table = tableCells[0].getParentTable(); Logger.log('Number of table cells selected: ' + tableCells.length); }
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTextRange()
הפונקציה מחזירה את הערך TextRange
שנבחר או את הערך null
אם הבחירה אינה מסוג
SelectionType.TEXT
.
השדה TextRange
מייצג שני תרחישים:
1. טווח הטקסט נבחר. לדוגמה, אם בצורה כלשהי יש את הטקסט "Hello" (שלום) והאפשרות "He" נבחרה,
הטווח שיוחזר יכלול את TextRange.getStartIndex()
= 0 ו-TextRange.getEndIndex()
=
2.
2. מיקום הסמן. לדוגמה, אם בצורה כלשהי יש את הטקסט "Hello" והסמן מופיע אחרי "H",
("H|ello"), הטווח המוחזר מכיל את הטקסט TextRange.getStartIndex()
= 1 ו-TextRange.getEndIndex()
= 1.
var selection = SlidesApp.getActivePresentation().getSelection(); var selectionType = selection.getSelectionType(); if (selectionType == SlidesApp.SelectionType.TEXT) { var currentPage = selection.getCurrentPage(); var pageElement = selection.getPageElementRange().getPageElements()[0]; var textRange = selection.getTextRange(); Logger.log('Text selected: ' + textRange.asString()); }
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations