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

החזרות

TextRange

הרשאות

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

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