Class Selection

בחירה

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

const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();
const selectionType = selection.getSelectionType();

Methods

שיטהסוג הערך המוחזרתיאור קצר
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 הפעילים כרגע, או את הערך 'לא קיים' אם אין דף פעיל. 

const selection = SlidesApp.getActivePresentation().getSelection();
const 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. 

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.PAGE_ELEMENT) {
  const currentPage = selection.getCurrentPage();
  const 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. 

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.PAGE) {
  const 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. 

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.CURRENT_PAGE) {
  const 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. 

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.TABLE_CELL) {
  const currentPage = selection.getCurrentPage();
  const tableCells = selection.getTableCellRange().getTableCells();
  const 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. מיקום הסמן. לדוגמה, אם בצורך מופיע הטקסט 'שלום', והסמן נמצא אחרי האות 'ה' ('ה|שלום'), בטווח המוחזר הערכים TextRange.getStartIndex() = 1 ו-TextRange.getEndIndex() = 1. 

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.TEXT) {
  const currentPage = selection.getCurrentPage();
  const pageElement = selection.getPageElementRange().getPageElements()[0];
  const textRange = selection.getTextRange();
  Logger.log(`Text selected: ${textRange.asString()}`);
}

חזרה

TextRange

אישור

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

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