Class Selection

Selezione

La selezione dell'utente nella presentazione attiva.

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

Metodi

Metodo	Tipo restituito	Breve descrizione
getCurrentPage()	Page	Restituisce Page o null attualmente attivo se non è presente una pagina attiva.
getPageElementRange()	PageElementRange	Restituisce la raccolta PageElementRange di istanze PageElement selezionate o null se non sono selezionate istanze PageElement.
getPageRange()	PageRange	Restituisce PageRange una raccolta di istanze Page nel filmstrip selezionate o null se la selezione non è di tipo SelectionType.PAGE.
getSelectionType()	SelectionType	Restituisce il SelectionType.
getTableCellRange()	TableCellRange	Restituisce la raccolta TableCellRange di istanze TableCell selezionate o null se non sono selezionate istanze TableCell.
getTextRange()	TextRange	Restituisce il TextRange selezionato o null se la selezione non è di tipo SelectionType.TEXT.

Documentazione dettagliata

getCurrentPage()

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

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

Invio

Page

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

Invio

PageElementRange

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

Invio

PageRange

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

Invio

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

Invio

TableCellRange

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 il 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 "Ciao" e "Lui" è selezionato, l'intervallo restituito ha TextRange.getStartIndex() = 0 e TextRange.getEndIndex() = 2.

2. Posizione del cursore. Ad esempio, se una forma contiene il testo "Ciao" e il cursore si trova dopo "C", ("C|iao"), 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()}`);
}

Invio

TextRange

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