Class Selection

Lựa chọn

Lựa chọn của người dùng trong bản trình bày đang hoạt động.

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

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
getCurrentPage()PageTrả về Page hoặc null đang hoạt động nếu không có trang nào đang hoạt động.
getPageElementRange()PageElementRangeTrả về tập hợp PageElementRange của các thực thể PageElement đã được chọn hoặc null nếu không có thực thể PageElement nào được chọn.
getPageRange()PageRangeTrả về PageRange một tập hợp các thực thể Page trong dải phim được chọn hoặc null nếu lựa chọn không thuộc loại SelectionType.PAGE.
getSelectionType()SelectionTypeTrả về SelectionType.
getTableCellRange()TableCellRangeTrả về tập hợp TableCellRange của các thực thể TableCell đã chọn hoặc null nếu không có thực thể TableCell nào được chọn.
getTextRange()TextRangeTrả về TextRange đã chọn hoặc null nếu lựa chọn không thuộc loại SelectionType.TEXT.

Tài liệu chi tiết

getCurrentPage()

Trả về Page hoặc null đang hoạt động nếu không có trang nào đang hoạt động.

const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();
if (currentPage != null) {
  Logger.log(`Selected current active page ID: ${currentPage.getObjectId()}`);
}

Cầu thủ trả bóng

Page

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getPageElementRange()

Trả về tập hợp PageElementRange của các thực thể PageElement đã được chọn hoặc null nếu không có thực thể PageElement nào được chọn.

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

Cầu thủ trả bóng

PageElementRange

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getPageRange()

Trả về PageRange một tập hợp các thực thể Page trong dải phim được chọn hoặc null nếu lựa chọn không thuộc loại 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}`,
  );
}

Cầu thủ trả bóng

PageRange

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getSelectionType()

Trả về 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()}`);
}

Cầu thủ trả bóng

SelectionType

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getTableCellRange()

Trả về tập hợp TableCellRange của các thực thể TableCell đã chọn hoặc null nếu không có thực thể TableCell nào được chọn.

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

Cầu thủ trả bóng

TableCellRange

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getTextRange()

Trả về TextRange đã chọn hoặc null nếu lựa chọn không thuộc loại SelectionType.TEXT.

TextRange đại diện cho hai trường hợp:

1. Phạm vi văn bản đã chọn. Ví dụ: nếu một hình dạng có văn bản "Hello" (Xin chào) và "He" (Anh) được chọn, thì phạm vi được trả về sẽ có TextRange.getStartIndex() = 0 và TextRange.getEndIndex() = 2.

2. Vị trí con trỏ. Ví dụ: nếu một hình dạng có văn bản "Hello" và con trỏ nằm sau "H", ("H|ello"), thì dải ô được trả về sẽ có TextRange.getStartIndex() = 1 và 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()}`);
}

Cầu thủ trả bóng

TextRange

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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