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 コレクションを返します。 または null（TableCell インスタンスが選択されていない場合）。
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

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

  • 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

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

  • 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

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

  • 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

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

getTableCellRange()

選択された TableCell インスタンスの TableCellRange コレクションを返します。 または null（TableCell インスタンスが選択されていない場合）。 

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

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

getTextRange()

選択された TextRange を返します。選択内容が型でない場合には null を返します。 SelectionType.TEXT。

TextRange は、次の 2 つのシナリオを表します。

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

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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