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

Methode	Rückgabetyp	Kurzbeschreibung
getCurrentPage()	Page	Gibt den aktuell aktiven Page oder null zurück, wenn keine aktive Seite vorhanden ist.
getPageElementRange()	PageElementRange	Gibt die Sammlung PageElementRange von PageElement-Instanzen zurück, die ausgewählt oder null, wenn keine PageElement-Instanzen ausgewählt sind.
getPageRange()	PageRange	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.
getSelectionType()	SelectionType	Gibt SelectionType zurück.
getTableCellRange()	TableCellRange	Gibt die Sammlung TableCellRange der ausgewählten TableCell-Instanzen zurück oder null, wenn keine TableCell-Instanzen ausgewählt sind.
getTextRange()	TextRange	Gibt 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