Class Selection

การเลือก

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

var selection = SlidesApp.getActivePresentation().getSelection();
var currentPage = selection.getCurrentPage();
var 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 ที่ใช้งานอยู่ในขณะนี้ หากไม่มีหน้าที่ทำงานอยู่

var selection = SlidesApp.getActivePresentation().getSelection();
var 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 อินสแตนซ์

var selection = SlidesApp.getActivePresentation().getSelection();
var selectionType = selection.getSelectionType();
if (selectionType == SlidesApp.SelectionType.PAGE_ELEMENT) {
  var currentPage = selection.getCurrentPage();
  var 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

var selection = SlidesApp.getActivePresentation().getSelection();
var selectionType = selection.getSelectionType();
if (selectionType == SlidesApp.SelectionType.PAGE) {
  var 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

var selection = SlidesApp.getActivePresentation().getSelection();
var selectionType = selection.getSelectionType();
if (selectionType == SlidesApp.SelectionType.CURRENT_PAGE) {
  var 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 ไว้

var selection = SlidesApp.getActivePresentation().getSelection();
var selectionType = selection.getSelectionType();
if (selectionType == SlidesApp.SelectionType.TABLE_CELL) {
  var currentPage = selection.getCurrentPage();
  var tableCells = selection.getTableCellRange().getTableCells();
  var 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. ตำแหน่งเคอร์เซอร์ เช่น หากรูปร่างมีข้อความ "สวัสดี" และเคอร์เซอร์อยู่หลัง "H" ("H|ello") ช่วงที่แสดงผลมี TextRange.getStartIndex() = 1 และ TextRange.getEndIndex() = 1

var selection = SlidesApp.getActivePresentation().getSelection();
var selectionType = selection.getSelectionType();
if (selectionType == SlidesApp.SelectionType.TEXT) {
  var currentPage = selection.getCurrentPage();
  var pageElement = selection.getPageElementRange().getPageElements()[0];
  var textRange = selection.getTextRange();
  Logger.log('Text selected: ' + textRange.asString());
}

รีเทิร์น

TextRange

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

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

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