Trang này được dịch bởi Cloud Translation API.

Class Selection

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ức	Loại dữ liệu trả về	Mô tả ngắn
`getCurrentPage()`	`Page`	Trả về `Page` hoặc `null` đang hoạt động nếu không có trang nào đang hoạt động.
`getPageElementRange()`	`PageElementRange`	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.
`getPageRange()`	`PageRange`	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`.
`getSelectionType()`	`SelectionType`	Trả về `SelectionType`.
`getTableCellRange()`	`TableCellRange`	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.
`getTextRange()`	`TextRange`	Trả 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