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