Class Selection

Auswahl

Die Auswahl des Nutzers in der aktiven Präsentation.

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getCurrentPage()	Page	Gibt die aktuell aktive Page oder null zurück, wenn keine aktive Seite vorhanden ist.
getPageElementRange()	PageElementRange	Gibt die PageElementRange-Sammlung der ausgewählten PageElement-Instanzen zurück oder null, wenn keine PageElement-Instanzen ausgewählt sind.
getPageRange()	PageRange	Gibt die PageRange zurück, eine Sammlung von Page-Instanzen im Filmstreifen, die ausgewählt sind, oder null, wenn die Auswahl nicht vom Typ SelectionType.PAGE ist.
getSelectionType()	SelectionType	Gibt die SelectionType zurück.
getTableCellRange()	TableCellRange	Gibt die TableCellRange-Sammlung der ausgewählten TableCell-Instanzen zurück oder null, wenn keine TableCell-Instanzen ausgewählt sind.
getTextRange()	TextRange	Gibt das ausgewählte TextRange zurück oder null, wenn die Auswahl nicht vom Typ SelectionType.TEXT ist.

Detaillierte Dokumentation

getCurrentPage()

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

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

Rückflug

Page

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getPageElementRange()

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

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.PAGE_ELEMENT) {
  const currentPage = selection.getCurrentPage();
  const pageElements = selection.getPageElementRange().getPageElements();
  Logger.log(`Number of page elements selected: ${pageElements.length}`);
}

Rückflug

PageElementRange

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getPageRange()

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

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.PAGE) {
  const pageRange = selection.getPageRange();
  Logger.log(
      `Number of pages in the flimstrip selected: ${
          pageRange.getPages().length}`,
  );
}

Rückflug

PageRange

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getSelectionType()

Gibt die SelectionType zurück.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.CURRENT_PAGE) {
  const currentPage = selection.getCurrentPage();
  Logger.log(`Selected current active page ID: ${currentPage.getObjectId()}`);
}

Rückflug

SelectionType

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getTableCellRange()

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

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.TABLE_CELL) {
  const currentPage = selection.getCurrentPage();
  const tableCells = selection.getTableCellRange().getTableCells();
  const table = tableCells[0].getParentTable();
  Logger.log(`Number of table cells selected: ${tableCells.length}`);
}

Rückflug

TableCellRange

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getTextRange()

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

Das Symbol TextRange steht für zwei Szenarien:

1. Ausgewählter Textbereich 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 „Hallo“ enthält und sich der Cursor nach „H“ befindet („H|allo“), hat der zurückgegebene Bereich TextRange.getStartIndex() = 1 und TextRange.getEndIndex() = 1.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.TEXT) {
  const currentPage = selection.getCurrentPage();
  const pageElement = selection.getPageElementRange().getPageElements()[0];
  const textRange = selection.getTextRange();
  Logger.log(`Text selected: ${textRange.asString()}`);
}

Rückflug

TextRange

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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