Class Selection

Selezione

La selezione dell'utente nella presentazione attiva.

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

Metodi

Metodo	Tipo restituito	Breve descrizione
getCurrentPage()	Page	Restituisce Page o null attualmente attivo in assenza di pagine attive.
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 file flimstrip che sono selezionate o null se la selezione non è di tipo SelectionType.PAGE.
getSelectionType()	SelectionType	Restituisce SelectionType.
getTableCellRange()	TableCellRange	Restituisce la raccolta TableCellRange di istanze TableCell selezionate o null se non sono selezionate istanze TableCell.
getTextRange()	TextRange	Restituisce TextRange selezionato o null se la selezione non è di tipo SelectionType.TEXT.

Documentazione dettagliata

getCurrentPage()

Restituisce Page o null attualmente attivo in assenza di pagine attive.

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

Ritorni

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.

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

Ritorni

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 file flimstrip che sono selezionate o null se la selezione non è di tipo SelectionType.PAGE.

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

Ritorni

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

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

Ritorni

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.

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

Ritorni

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 TextRange selezionato o null se la selezione non è di tipo SelectionType.TEXT.

L'TextRange rappresenta due scenari:

1. Intervallo di testo selezionato. Ad esempio, se una forma contiene il testo "Ciao" ed è selezionato "Lui", l'intervallo restituito avrà 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 "H", ("H|ello"), l'intervallo restituito ha TextRange.getStartIndex() = 1 e 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());
}

Ritorni

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