Class Selection

선택

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

const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();
const 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를 반환하거나 선택이 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

승인

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

  • 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

승인

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

  • 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

승인

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

  • 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

승인

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

  • 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

승인

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

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