Class Selection

선택

활성 프레젠테이션에서 사용자가 선택한 항목 

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

메서드

메서드반환 유형간략한 설명
getCurrentPage()Page현재 활성화된 Page 또는 null를 반환합니다(활성 페이지가 없는 경우).
getPageElementRange()PageElementRange다음 조건을 충족하는 PageElement 인스턴스의 PageElementRange 컬렉션을 반환합니다. 선택된 PageElement 인스턴스가 없는 경우 null입니다.
getPageRange()PageRange다음과 같은 플림스트립의 Page 인스턴스 모음인 PageRange를 반환합니다. 선택되거나 선택 항목이 SelectionType.PAGE 유형이 아닌 경우 null입니다.
getSelectionType()SelectionTypeSelectionType를 반환합니다.
getTableCellRange()TableCellRange선택된 TableCell 인스턴스의 TableCellRange 컬렉션을 반환합니다. 또는 선택된 TableCell 인스턴스가 없는 경우 null입니다.
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

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getPageElementRange()

다음 조건을 충족하는 PageElement 인스턴스의 PageElementRange 컬렉션을 반환합니다. 선택된 PageElement 인스턴스가 없는 경우 null입니다. 

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

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getPageRange()

다음과 같은 플림스트립의 Page 인스턴스 모음인 PageRange를 반환합니다. 선택되거나 선택 항목이 SelectionType.PAGE 유형이 아닌 경우 null입니다. 

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

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • 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

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getTableCellRange()

선택된 TableCell 인스턴스의 TableCellRange 컬렉션을 반환합니다. 또는 선택된 TableCell 인스턴스가 없는 경우 null입니다. 

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

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

getTextRange()

선택된 TextRange를 반환하거나 선택 유형이 유형이 아닌 경우 null을 반환합니다. SelectionType.TEXT입니다.

TextRange는 두 가지 시나리오를 나타냅니다.

1. 선택한 텍스트 범위입니다. 예를 들어 도형에 'Hello'와 'He'라는 텍스트가 있는 경우 선택되면 반환된 범위는 TextRange.getStartIndex() = 0 및 TextRange.getEndIndex() =입니다. 2.

2. 커서 위치입니다. 예를 들어 도형에 'Hello' 텍스트가 있고 커서가 '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

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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