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

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

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

  • 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

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

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

  • 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

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

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

  • 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

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

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

  • 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

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

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

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