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

MethodeRückgabetypKurzbeschreibung
getCurrentPage()Page|nullGibt die aktuell aktive Page oder null zurück, wenn keine aktive Seite vorhanden ist.
getPageElementRange()PageElementRange|nullGibt die PageElementRange-Sammlung von PageElement-Instanzen zurück, die ausgewählt sind, oder null, wenn keine PageElement-Instanzen ausgewählt sind.
getPageRange()PageRange|nullGibt 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()SelectionTypeGibt die SelectionType zurück.
getTableCellRange()TableCellRange|nullGibt die TableCellRange-Sammlung der ausgewählten TableCell-Instanzen oder null zurück, wenn keine TableCell-Instanzen ausgewählt sind.
getTextRange()TextRange|nullGibt 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|null

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getPageElementRange()

Gibt die PageElementRange-Sammlung von PageElement-Instanzen zurück, die ausgewählt sind, 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|null

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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|null

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getTableCellRange()

Gibt die TableCellRange-Sammlung der ausgewählten TableCell-Instanzen oder null zurück, 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|null

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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.

TextRange steht für zwei Szenarien:

1. Es wurde ein Textbereich ausgewählt. Wenn eine Form beispielsweise den Text „Hallo“ enthält und „He“ 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 dem „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|null

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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