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 den aktuell aktiven Page oder null zurück, wenn keine aktive Seite vorhanden ist.
getPageElementRange()PageElementRangeGibt die Sammlung PageElementRange von PageElement-Instanzen zurück, die ausgewählt oder null, wenn keine PageElement-Instanzen ausgewählt sind.
getPageRange()PageRangeGibt dem PageRange eine Sammlung von Page-Instanzen in Flimstrip zurück, die ausgewählt oder null, wenn die Auswahl nicht vom Typ SelectionType.PAGE ist.
getSelectionType()SelectionTypeGibt SelectionType zurück.
getTableCellRange()TableCellRangeGibt die Sammlung TableCellRange der ausgewählten TableCell-Instanzen zurück oder null, wenn keine TableCell-Instanzen ausgewählt sind.
getTextRange()TextRangeGibt die ausgewählte TextRange oder null zurück, wenn die Auswahl nicht vom Typ ist SelectionType.TEXT

Detaillierte Dokumentation

getCurrentPage()

Gibt den aktuell aktiven 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());
}

Rückflug

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 von PageElement-Instanzen zurück, die ausgewählt oder null, 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);
}

Rückflug

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 dem PageRange eine Sammlung von Page-Instanzen in Flimstrip zurück, die ausgewählt 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);
}
}

Rückflug

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

Rückflug

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 zurück oder null, 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);
}

Rückflug

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 die ausgewählte TextRange oder null zurück, wenn die Auswahl nicht vom Typ ist SelectionType.TEXT

TextRange stellt zwei Szenarien dar:

1. Textbereich ausgewählt. Beispiel: Wenn eine Form die Texte „Hallo“ und „He“ enthält ausgewählt ist, Der zurückgegebene Bereich ist TextRange.getStartIndex() = 0 und TextRange.getEndIndex() = 2.

2. Cursor position. Wenn eine Form z. B. den Text „Hallo“ enthält und der Cursor hinter „H“ steht, („H|ello“), 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());
}

Rückflug

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