Class Selection

Auswahl

Die Auswahl des Nutzers in der aktiven Präsentation.

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

Methoden

MethodeRückgabetypKurzbeschreibung
getCurrentPage()PageGibt das aktuell aktive Page oder null zurück, wenn keine aktive Seite vorhanden ist.
getPageElementRange()PageElementRangeGibt die Sammlung PageElementRange der ausgewählten PageElement-Instanzen oder null zurück, wenn keine PageElement-Instanzen ausgewählt sind.
getPageRange()PageRangeGibt PageRange eine Sammlung von Page-Instanzen im flimstrip zurück, die ausgewählt sind, oder null, wenn die Auswahl nicht vom Typ SelectionType.PAGE ist.
getSelectionType()SelectionTypeGibt das SelectionType zurück.
getTableCellRange()TableCellRangeGibt die Sammlung TableCellRange der ausgewählten TableCell-Instanzen oder null zurück, wenn keine TableCell-Instanzen ausgewählt sind.
getTextRange()TextRangeGibt das ausgewählte TextRange oder null zurück, wenn die Auswahl nicht den Typ SelectionType.TEXT hat.

Detaillierte Dokumentation

getCurrentPage()

Gibt das aktuell aktive Page oder null zurück, wenn keine aktive Seite vorhanden ist.

var selection = SlidesApp.getActivePresentation().getSelection();
var currentPage = selection.getCurrentPage();
if (currentPage != null) {
  Logger.log('Selected current active page ID: ' + currentPage.getObjectId());
}

Return

Page

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getPageElementRange()

Gibt die Sammlung PageElementRange der ausgewählten PageElement-Instanzen oder null zurück, wenn keine PageElement-Instanzen ausgewählt sind.

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);
}

Return

PageElementRange

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getPageRange()

Gibt PageRange eine Sammlung von Page-Instanzen im flimstrip zurück, die ausgewählt sind, oder null, wenn die Auswahl nicht vom Typ SelectionType.PAGE ist.

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);
}
}

Return

PageRange

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getSelectionType()

Gibt das SelectionType zurück.

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());
}

Return

SelectionType

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getTableCellRange()

Gibt die Sammlung TableCellRange der ausgewählten TableCell-Instanzen oder null zurück, wenn keine TableCell-Instanzen ausgewählt sind.

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);
}

Return

TableCellRange

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getTextRange()

Gibt das ausgewählte TextRange oder null zurück, wenn die Auswahl nicht den Typ SelectionType.TEXT hat.

TextRange stellt zwei Szenarien dar:

1. Textbereich ausgewählt. Wenn eine Form beispielsweise den Text „Hallo“ enthält und „Er“ ausgewählt ist, hat der zurückgegebene Bereich TextRange.getStartIndex() = 0 und TextRange.getEndIndex() = 2.

2. Cursor position. Wenn eine Form beispielsweise den Text „Hello“ enthält und der Cursor nach „H“ („H|ello“) steht, hat der zurückgegebene Bereich TextRange.getStartIndex() = 1 und 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());
}

Return

TextRange

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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