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