Class Selection

Selezione

La selezione dell'utente nella presentazione attiva.

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

Metodi

MetodoTipo restituitoBreve descrizione
getCurrentPage()Page|nullRestituisce il Page o il null attualmente attivo se non è presente alcuna pagina attiva.
getPageElementRange()PageElementRange|nullRestituisce la raccolta PageElementRange di istanze PageElement selezionate o null se non sono selezionate istanze PageElement.
getPageRange()PageRange|nullRestituisce PageRange una raccolta di istanze Page nella striscia di pellicola che sono selezionate o null se la selezione non è di tipo SelectionType.PAGE.
getSelectionType()SelectionTypeRestituisce SelectionType.
getTableCellRange()TableCellRange|nullRestituisce la raccolta TableCellRange di istanze TableCell selezionate o null se non sono selezionate istanze TableCell.
getTextRange()TextRange|nullRestituisce TextRange selezionato o null se la selezione non è di tipo SelectionType.TEXT.

Documentazione dettagliata

getCurrentPage()

Restituisce il Page o il null attualmente attivo se non è presente alcuna pagina attiva.

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

Indietro

Page|null

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getPageElementRange()

Restituisce la raccolta PageElementRange di istanze PageElement selezionate o null se non sono selezionate istanze PageElement.

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

Indietro

PageElementRange|null

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getPageRange()

Restituisce PageRange una raccolta di istanze Page nella striscia di pellicola che sono selezionate o null se la selezione non è di tipo SelectionType.PAGE.

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

Indietro

PageRange|null

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getSelectionType()

Restituisce SelectionType.

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

Indietro

SelectionType

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getTableCellRange()

Restituisce la raccolta TableCellRange di istanze TableCell selezionate o null se non sono selezionate istanze TableCell.

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

Indietro

TableCellRange|null

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getTextRange()

Restituisce TextRange selezionato o null se la selezione non è di tipo SelectionType.TEXT.

TextRange rappresenta due scenari:

1. Intervallo di testo selezionato. Ad esempio, se una forma contiene il testo "Hello" e viene selezionato "He", l'intervallo restituito ha TextRange.getStartIndex() = 0 e TextRange.getEndIndex() = 2.

2. Posizione del cursore. Ad esempio, se una forma contiene il testo "Hello" e il cursore si trova dopo "H", ("H|ello"), l'intervallo restituito ha TextRange.getStartIndex() = 1 e 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()}`);
}

Indietro

TextRange|null

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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