Class Selection

선택

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

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

메서드

메서드반환 유형간략한 설명
getCurrentPage()Page|null현재 활성 상태인 Page를 반환합니다. 활성 상태인 페이지가 없으면 null를 반환합니다.
getPageElementRange()PageElementRange|null선택된 PageElement 인스턴스의 PageElementRange 컬렉션을 반환하거나 선택된 PageElement 인스턴스가 없는 경우 null를 반환합니다.
getPageRange()PageRange|null선택된 필름 스트립의 Page 인스턴스 컬렉션인 PageRange을 반환하거나 선택이 SelectionType.PAGE 유형이 아닌 경우 null을 반환합니다.
getSelectionType()SelectionTypeSelectionType를 반환합니다.
getTableCellRange()TableCellRange|null선택된 TableCell 인스턴스의 TableCellRange 컬렉션을 반환합니다. 선택된 TableCell 인스턴스가 없는 경우 null를 반환합니다.
getTextRange()TextRange|null선택된 TextRange를 반환하거나 선택이 SelectionType.TEXT 유형이 아닌 경우 null을 반환합니다.

자세한 문서

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|null

승인

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

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

getPageElementRange()

선택된 PageElement 인스턴스의 PageElementRange 컬렉션을 반환하거나 선택된 PageElement 인스턴스가 없는 경우 null를 반환합니다. 

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|null

승인

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

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

getPageRange()

선택된 필름 스트립의 Page 인스턴스 컬렉션인 PageRange을 반환하거나 선택이 SelectionType.PAGE 유형이 아닌 경우 null을 반환합니다. 

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|null

승인

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

  • 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

승인

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

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

getTableCellRange()

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

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|null

승인

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

  • 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입니다. 

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|null

승인

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

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