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

프레젠테이션 내에서 항목 선택

선택은 열려 있는 프레젠테이션 페이지에서 현재 선택된 항목(예: 강조 표시된 텍스트 범위 또는 표)입니다. 이 가이드에서는 Apps Script를 사용하여 활성 프레젠테이션에서 선택 영역을 가져오고 설정하는 방법을 설명합니다.

선택은 스크립트가 시작될 때의 스냅샷입니다. 스크립트가 실행되는 동안 사용자가 클릭하여 선택사항이 변경되면 이러한 변경사항이 반영되지 않습니다.

선택 및 선택 유형

Selection 클래스를 사용하여 선택사항을 읽을 수 있습니다. 이 클래스에는 선택한 객체의 유형에 따라 선택한 객체를 가져오는 다양한 메서드가 있습니다.

SelectionType 열거형은 선택된 객체의 특정 유형을 나타냅니다. 예를 들어 사용자가 도형에서 텍스트를 선택한 경우 선택 유형은 TEXT가 됩니다. 이 경우 selection.getTextRange() 메서드를 사용하여 선택된 텍스트 범위를 가져올 수 있습니다.

선택 항목이 포함된 객체를 가져올 수도 있습니다. 위의 예시를 계속해서 살펴보면 selection.getPageElementRange().getPageElements()[0]를 사용하여 선택한 텍스트가 포함된 도형을 가져올 수 있습니다. 마찬가지로, 묶는 도형을 포함하는 페이지가 현재 활성 페이지입니다. 이 페이지를 가져오려면 selection.getCurrentPage()를 사용하세요.

선택 항목 읽기

선택 항목을 읽으려면 다음 예와 같이 Presentation.getSelection() 메서드를 사용합니다.

slides/selection/selection.gs

GitHub에서 보기

const selection = SlidesApp.getActivePresentation().getSelection();

현재 페이지 읽기

사용자가 보고 있는 현재 페이지를 가져오려면 다음과 같이 getSelection() 및 getCurrentPage() 메서드를 사용합니다.

slides/selection/selection.gs

GitHub에서 보기

const currentPage = SlidesApp.getActivePresentation().getSelection().getCurrentPage();

현재 페이지는 다음 유형 중 하나일 수 있습니다.

현재 페이지에는 하나 이상의 객체가 선택되어 있을 수 있으며 SelectionType은 선택 유형을 결정합니다.

선택 유형에 따라 선택 항목 읽기

다음 예시에서는 선택 유형을 사용하여 유형에 적합한 방식으로 현재 선택을 읽는 방법을 보여줍니다.

slides/selection/selection.gs

GitHub에서 보기

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
let currentPage;
switch (selectionType) {
  case SlidesApp.SelectionType.NONE:
    console.log('Nothing selected');
    break;
  case SlidesApp.SelectionType.CURRENT_PAGE:
    currentPage = selection.getCurrentPage();
    console.log('Selection is a page with ID: ' + currentPage.getObjectId());
    break;
  case SlidesApp.SelectionType.PAGE_ELEMENT:
    const pageElements = selection.getPageElementRange().getPageElements();
    console.log('There are ' + pageElements.length + ' page elements selected.');
    break;
  case SlidesApp.SelectionType.TEXT:
    const tableCellRange = selection.getTableCellRange();
    if (tableCellRange !== null) {
      const tableCell = tableCellRange.getTableCells()[0];
      console.log('Selected text is in a table at row ' +
        tableCell.getRowIndex() + ', column ' +
        tableCell.getColumnIndex());
    }
    const textRange = selection.getTextRange();
    if (textRange.getStartIndex() === textRange.getEndIndex()) {
      console.log('Text cursor position: ' + textRange.getStartIndex());
    } else {
      console.log('Selection is a text range from: ' + textRange.getStartIndex() + ' to: ' +
        textRange.getEndIndex() + ' is selected');
    }
    break;
  case SlidesApp.SelectionType.TABLE_CELL:
    const tableCells = selection.getTableCellRange().getTableCells();
    const table = tableCells[0].getParentTable();
    console.log('There are ' + tableCells.length + ' table cells selected.');
    break;
  case SlidesApp.SelectionType.PAGE:
    const pages = selection.getPageRange().getPages();
    console.log('There are ' + pages.length + ' pages selected.');
    break;
  default:
    break;
}

텍스트 선택 읽기

Selection.getTextRange() 메서드를 사용하여 텍스트 선택을 읽을 수 있습니다. 텍스트 선택에는 두 가지 유형이 있습니다.

범위 선택: 도형에 'Hello'라는 텍스트가 포함되어 있고 'He'가 선택된 경우 반환된 범위의 startIndex는 0이고 endIndex는 2입니다.
커서 선택: 도형에 'Hello'라는 텍스트가 포함되어 있고 커서가 'H' 뒤에 있는 경우('H|ello') 반환된 범위는 startIndex=1 및 endIndex=1인 빈 범위입니다.

선택 항목 수정

스크립트에서 사용자의 선택을 수정할 수 있습니다. 스크립트가 프레젠테이션에 적용하는 선택 변경사항은 스크립트 실행 기간 동안 후속 선택 작업에 반영됩니다.

선택 변경사항은 스크립트 실행이 완료된 후 또는 Presentation.saveAndClose()가 호출된 경우에만 사용자의 브라우저에 반영됩니다.

현재 페이지 선택

활성 프레젠테이션의 페이지는 selectAsCurrentPage() 메서드를 호출하여 현재 페이지로 선택할 수 있습니다. 이 메서드는 이전 페이지 요소, 페이지 또는 텍스트 선택을 삭제합니다. 따라서 현재 페이지에서 이 메서드를 사용하면 페이지에서 현재 선택된 항목을 선택 해제할 수 있습니다. 예를 들면 다음과 같습니다.

slides/selection/selection.gs

GitHub에서 보기

// Select the first slide as the current page selection and remove any previous selection.
  const selection = SlidesApp.getActivePresentation().getSelection();
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  slide.selectAsCurrentPage();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.CURRENT_PAGE
// selection.getCurrentPage() = slide
//

페이지 요소 선택

페이지에서 페이지 요소를 선택하려면 PageElement.select() 메서드를 사용합니다. 이렇게 하면 이전에 선택한 페이지 요소도 선택 해제됩니다.

select() 및 select(true) 메서드는 동일합니다.

예를 들면 다음과 같습니다.

slides/selection/selection.gs

GitHub에서 보기

  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const pageElement = slide.getPageElements()[0];
  // Only select this page element and remove any previous selection.
  pageElement.select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = pageElement
//

여러 페이지 요소 선택

선택 항목에 페이지 요소를 추가하려면 PageElement.select(false) 메서드를 사용합니다. 모든 페이지 요소는 현재 페이지에 있어야 합니다.

slides/selection/selection.gs

GitHub에서 보기

  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // First select the slide page, as the current page selection.
  slide.selectAsCurrentPage();
  // Then select all the page elements in the selected slide page.
  const pageElements = slide.getPageElements();
  for (let i = 0; i < pageElements.length; i++) {
    pageElements[i].select(false);
  }
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements() = pageElements
//

선택 영역 변환

스크립트에서 실행하는 수정사항은 현재 선택사항을 변환할 수 있으므로 수정 결과로 선택된 항목이 변경됩니다. 예를 들면 다음과 같습니다.

도형 A와 B가 선택되어 있다고 가정해 보겠습니다.
그런 다음 스크립트가 도형 A를 삭제합니다.
따라서 모양 B만 선택되도록 선택 항목이 수정에 대해 변환됩니다.

다음 예에서는 선택한 페이지 요소를 조작하여 선택 영역을 변환하는 방법을 보여줍니다.

slides/selection/selection.gs

GitHub에서 보기

  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const shape1 = slide.getPageElements()[0].asShape();
  const shape2 = slide.getPageElements()[1].asShape();
  // Select both the shapes.
  shape1.select();
  shape2.select(false);
  // State of selection
  //
  // selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
  // selection.getCurrentPage() = slide
  // selection.getPageElementRange().getPageElements() = [shape1, shape2]
  //
  // Remove one shape.
  shape2.remove();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements() = [shape1]
//

텍스트 선택

도형 또는 표 셀에 포함된 텍스트는 TextRange.select() 메서드를 사용하여 선택할 수 있습니다. 텍스트가 도형에 포함되어 있으면 해당 도형도 선택됩니다. 텍스트가 표 셀에 포함되어 있으면 해당 표 셀과 이를 둘러싼 표가 모두 선택됩니다.

이렇게 하면 상위 페이지가 현재 페이지로 설정됩니다.

도형의 범위 선택

다음 예에서는 도형에 포함된 텍스트 내에서 범위 선택을 하는 방법을 보여줍니다.

slides/selection/selection.gs

GitHub에서 보기

  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const shape = slide.getPageElements()[0].asShape();
  shape.getText().setText('Hello');
  // Range selection: Select the text range 'He'.
  shape.getText().getRange(0, 2).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = shape
// selection.getTextRange().getStartIndex() = 0
// selection.getTextRange().getEndIndex() = 2
//

도형의 커서 선택

다음 예에서는 도형에 포함된 텍스트 내에서 커서 선택을 만드는 방법을 보여줍니다.

slides/selection/selection.gs

GitHub에서 보기

  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const shape = slide.getPageElements()[0].asShape();
  shape.getText().setText('Hello');
  // Cursor selection: Place the cursor after 'H' like 'H|ello'.
  shape.getText().getRange(1, 1).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = shape
// selection.getTextRange().getStartIndex() = 1
// selection.getTextRange().getEndIndex() = 1
//

표 셀의 범위 선택

다음 예시는 표 셀에 포함된 텍스트 내에서 범위 선택을 하는 방법을 보여줍니다.

slides/selection/selection.gs

GitHub에서 보기

  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const table = slide.getPageElements()[0].asTable();
  const tableCell = table.getCell(0, 1);
  tableCell.getText().setText('Hello');
  // Range selection: Select the text range 'He'.
  tableCell.getText().getRange(0, 2).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = table
// selection.getTableCellRange().getTableCells()[0] = tableCell
// selection.getTextRange().getStartIndex() = 0
// selection.getTextRange().getEndIndex() = 2
//

TableCell의 커서 선택

다음 예에서는 표 셀에 포함된 텍스트 내에서 커서를 선택하는 방법을 보여줍니다.

slides/selection/selection.gs

GitHub에서 보기

  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const table = slide.getPageElements()[0].asTable();
  const tableCell = table.getCell(0, 1);
  tableCell.getText().setText('Hello');
  // Cursor selection: Place the cursor after 'H' like 'H|ello'.
  tableCell.getText().getRange(1, 1).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = table
// selection.getTableCellRange().getTableCells()[0] = tableCell
// selection.getTextRange().getStartIndex() = 1
// selection.getTextRange().getEndIndex() = 1
//

텍스트 수정이 포함된 선택 변환

다음 예에서는 선택한 텍스트를 수정하여 선택 항목을 변환하는 방법을 보여줍니다.

slides/selection/selection.gs

GitHub에서 보기

  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const shape = slide.getPageElements()[0].asShape();
  const textRange = shape.getText();
  textRange.setText('World');
  // Select all the text 'World'.
  textRange.select();
  // State of selection
  //
  // selection.getSelectionType() = SlidesApp.SelectionType.TEXT
  // selection.getCurrentPage() = slide
  // selection.getPageElementRange().getPageElements()[0] = shape
  // selection.getTextRange().getStartIndex() = 0
  // selection.getTextRange().getEndIndex() = 6
  //
  // Add some text to the shape, and the selection will be transformed.
  textRange.insertText(0, 'Hello ');

// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = shape
// selection.getTextRange().getStartIndex() = 0
// selection.getTextRange().getEndIndex() = 12
//

선택 해제

텍스트 또는 페이지 요소를 선택 해제하는 명시적 방법은 없습니다. 하지만 Page.selectAsCurrentPage() 또는 pageElement.select() 메서드를 사용하여 이 결과를 얻을 수 있습니다.

현재 페이지 선택

다음 예에서는 페이지를 현재 페이지로 설정하여 페이지에서 현재 선택된 항목을 선택 해제하는 방법을 보여줍니다.

slides/selection/selection.gs

GitHub에서 보기

// Unselect one or more page elements already selected.
//
// In case one or more page elements in the first slide are selected, setting the
// same (or any other) slide page as the current page would do the unselect.
//
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  slide.selectAsCurrentPage();

페이지 요소 선택

다음 예에서는 페이지에서 페이지 요소를 하나 선택하여 현재 선택된 항목을 선택 해제하여 선택 항목에서 다른 모든 항목을 삭제하는 방법을 보여줍니다.

slides/selection/selection.gs

GitHub에서 보기

// Unselect one or more page elements already selected.
//
// In case one or more page elements in the first slide are selected,
// selecting any pageElement in the first slide (or any other pageElement) would
// do the unselect and select that pageElement.
//
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  slide.getPageElements()[0].select();

프레젠테이션 내에서 항목 선택 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

선택 및 선택 유형

선택 항목 읽기

현재 페이지 읽기

선택 유형에 따라 선택 항목 읽기

텍스트 선택 읽기

선택 항목 수정

현재 페이지 선택

페이지 요소 선택

여러 페이지 요소 선택

선택 영역 변환

텍스트 선택

도형의 범위 선택

도형의 커서 선택

표 셀의 범위 선택

TableCell의 커서 선택

텍스트 수정이 포함된 선택 변환

선택 해제

현재 페이지 선택

페이지 요소 선택

프레젠테이션 내에서 항목 선택