이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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()`	`SelectionType`	`SelectionType`를 반환합니다.
`getTableCellRange()`	`TableCellRange`	선택된 `TableCell` 인스턴스의 `TableCellRange` 컬렉션을 반환하거나 선택된 `TableCell` 인스턴스가 없는 경우 `null`를 반환합니다.
`getTextRange()`	`TextRange`	선택된 `TextRange`을 반환하거나 선택 항목이 `SelectionType.TEXT` 유형이 아닌 경우 `null`를 반환합니다.

자세한 문서

`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을 반환하거나 선택 항목이 SelectionType.TEXT 유형이 아닌 경우 null를 반환합니다.

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