このページは 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` コレクションを返します。または `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