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