Class Selection

בחירה

הבחירה של המשתמש במצגת הפעילה.

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());
}

חזרה

Page

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

• 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);
}

חזרה

PageElementRange

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

• 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);
}
}

חזרה

PageRange

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

• 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());
}

חזרה

SelectionType

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

• 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);
}

חזרה

TableCellRange

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getTextRange()

הפונקציה מחזירה את הערך TextRange שנבחר או את הערך null אם הבחירה היא לא מסוג SelectionType.TEXT.

הפונקציה TextRange מייצגת שני תרחישים:

1. נבחר טווח הטקסט. לדוגמה אם צורה מכילה את הטקסט 'שלום' ו'הוא' נבחר, הטווח שמוחזר הוא 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());
}

חזרה

TextRange

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations