หน้านี้ได้รับการแปลโดย Cloud Translation API

Class Selection

การเลือกของผู้ใช้ในงานนำเสนอที่ใช้งานอยู่

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

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getCurrentPage()`	`Page`	แสดง `Page` หรือ `null` ที่ใช้งานอยู่ในปัจจุบัน หากไม่มีหน้าเว็บที่ใช้งานอยู่
`getPageElementRange()`	`PageElementRange`	แสดง`PageElementRange`คอลเล็กชันอินสแตนซ์ `PageElement` ที่เลือกไว้ หรือ `null` หากไม่ได้เลือกอินสแตนซ์ `PageElement`
`getPageRange()`	`PageRange`	แสดงผล `PageRange` ซึ่งเป็นคอลเล็กชันอินสแตนซ์ `Page` ในแถบแสดงตัวอย่างที่เลือกไว้ หรือ `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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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 ในแถบแสดงตัวอย่างที่เลือกไว้ หรือ 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 แสดงถึง 2 สถานการณ์ ดังนี้

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