Selezionare elementi in una presentazione

La selezione è il contenuto su cui è attivo il focus in una pagina di presentazione aperta, ad esempio un intervallo di testo evidenziato o una tabella. Questa guida descrive come ottenere e impostare la selezione in una presentazione attiva utilizzando Apps Script.

Uno script può accedere solo alla selezione dell'utente che lo esegue.

La selezione è un'istantanea di ciò che era all'avvio dello script. Se l'utente fa clic e la selezione cambia durante l'esecuzione dello script, queste modifiche non verranno riflesse.

Selezioni e tipo di selezione

Leggi la selezione utilizzando la classe Selection. La classe ha vari metodi per ottenere gli oggetti selezionati in base al tipo di oggetto o oggetti selezionati.

L'enumerazione SelectionType rappresenta il tipo specifico di oggetti selezionati. Ad esempio, se l'utente ha selezionato del testo in una forma, il tipo di selezione è TEXT. In questo caso, puoi recuperare l'intervallo di testo selezionato utilizzando il metodo selection.getTextRange().

Puoi anche recuperare l'oggetto che contiene la selezione. Ad esempio, puoi recuperare la forma contenente il testo selezionato utilizzando selection.getPageElementRange().getPageElements()[0]. Allo stesso modo, la pagina che contiene la forma racchiusa è la pagina attiva corrente; per recuperarla, utilizza selection.getCurrentPage().

Lettura della selezione

Per leggere la selezione, utilizza il metodo Presentation.getSelection() come mostrato nell'esempio seguente:

slides/selection/selection.gs
const selection = SlidesApp.getActivePresentation().getSelection();

Leggere la pagina corrente

Per recuperare la pagina attuale visualizzata dall'utente, utilizza i metodi getSelection() e getCurrentPage() come segue:

slides/selection/selection.gs
const currentPage = SlidesApp.getActivePresentation()
  .getSelection()
  .getCurrentPage();

Tieni presente che la pagina corrente può essere di uno dei seguenti tipi:

La pagina corrente può avere uno o più oggetti selezionati e SelectionType determina il tipo di selezione.

Leggi la selezione in base al tipo di selezione

L'esempio seguente mostra come utilizzare il tipo di selezione per leggere la selezione corrente in modo appropriato per il tipo.

slides/selection/selection.gs
const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
let currentPage;
switch (selectionType) {
  case SlidesApp.SelectionType.NONE:
    console.log("Nothing selected");
    break;
  case SlidesApp.SelectionType.CURRENT_PAGE:
    currentPage = selection.getCurrentPage();
    console.log(`Selection is a page with ID: ${currentPage.getObjectId()}`);
    break;
  case SlidesApp.SelectionType.PAGE_ELEMENT: {
    const pageElements = selection.getPageElementRange().getPageElements();
    console.log(`There are ${pageElements.length} page elements selected.`);
    break;
  }
  case SlidesApp.SelectionType.TEXT: {
    const tableCellRange = selection.getTableCellRange();
    if (tableCellRange !== null) {
      const tableCell = tableCellRange.getTableCells()[0];
      console.log(
        `Selected text is in a table at row ${tableCell.getRowIndex()}, column ${tableCell.getColumnIndex()}`,
      );
    }
    const textRange = selection.getTextRange();
    if (textRange.getStartIndex() === textRange.getEndIndex()) {
      console.log(`Text cursor position: ${textRange.getStartIndex()}`);
    } else {
      console.log(
        `Selection is a text range from: ${textRange.getStartIndex()} to: ${textRange.getEndIndex()} is selected`,
      );
    }
    break;
  }
  case SlidesApp.SelectionType.TABLE_CELL: {
    const tableCells = selection.getTableCellRange().getTableCells();
    const table = tableCells[0].getParentTable();
    console.log(`There are ${tableCells.length} table cells selected.`);
    break;
  }
  case SlidesApp.SelectionType.PAGE: {
    const pages = selection.getPageRange().getPages();
    console.log(`There are ${pages.length} pages selected.`);
    break;
  }
  default:
    break;
}

Leggere le selezioni di testo

Leggi la selezione di testo utilizzando il metodo Selection.getTextRange(). Esistono due tipi di selezione del testo:

  • Selezione intervallo: se una forma contiene il testo "Hello" e viene selezionato "He", l'intervallo restituito ha startIndex=0 ed endIndex=2.
  • Selezione del cursore: se una forma contiene il testo "Hello" e il cursore si trova dopo "H" ("H|ello"), l'intervallo restituito è un intervallo vuoto con startIndex=1 e endIndex=1.

Modifica della selezione

Lo script può modificare la selezione dell'utente. Tutte le modifiche alla selezione apportate dallo script alla presentazione vengono riflesse nelle operazioni di selezione successive per tutta la durata dell'esecuzione dello script.

Le modifiche alla selezione vengono visualizzate nel browser dell'utente solo dopo il completamento dell'esecuzione dello script o quando viene chiamato Presentation.saveAndClose().

Selezionare la pagina corrente

Una pagina della presentazione attiva può essere selezionata come pagina corrente chiamando il metodo selectAsCurrentPage(). Questo metodo rimuove qualsiasi elemento di pagina, pagina o selezione di testo precedente. Pertanto, l'utilizzo di questo metodo nella pagina corrente ti consente di deselezionare le selezioni correnti nella pagina. Ad esempio:

slides/selection/selection.gs
// Select the first slide as the current page selection and remove any previous selection.
const selection = SlidesApp.getActivePresentation().getSelection();
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.CURRENT_PAGE
// selection.getCurrentPage() = slide
//

Seleziona un elemento della pagina

Per selezionare un elemento di una pagina, utilizza il metodo PageElement.select(). Vengono deselezionati anche gli elementi della pagina selezionati in precedenza.

I metodi select() e select(true) sono equivalenti.

Ad esempio:

slides/selection/selection.gs
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and remove any previous selection.
pageElement.select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = pageElement
//

Selezionare più elementi della pagina

Per aggiungere altri elementi della pagina alla selezione, utilizza il metodo PageElement.select(false). Tutti gli elementi della pagina devono trovarsi nella pagina corrente.

slides/selection/selection.gs
const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements() = pageElements
//

Trasformare la selezione

Le modifiche eseguite dallo script possono trasformare la selezione corrente, in modo che ciò che è selezionato cambi in seguito alla modifica. Ad esempio:

  1. Supponiamo di aver selezionato due forme, A e B.
  2. Successivamente, lo script rimuove la forma A.
  3. Di conseguenza, la selezione viene trasformata in base alla modifica in modo che venga selezionata solo la forma B.

L'esempio seguente mostra come la selezione può essere trasformata manipolando gli elementi della pagina selezionati.

slides/selection/selection.gs
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.getPageElements()[0].asShape();
const shape2 = slide.getPageElements()[1].asShape();
// Select both the shapes.
shape1.select();
shape2.select(false);
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements() = [shape1, shape2]
//
// Remove one shape.
shape2.remove();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.PAGE_ELEMENT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements() = [shape1]
//

Seleziona testo

Il testo contenuto in una forma o in una cella di una tabella può essere selezionato utilizzando il metodo TextRange.select(). Se il testo è contenuto in una forma, viene selezionata anche quest'ultima. Se il testo è contenuto in una cella di una tabella, vengono selezionate sia la cella sia la tabella che la contiene.

In questo modo, la pagina principale viene impostata come pagina corrente.

Selezione intervallo in una forma

Il seguente esempio mostra come selezionare un intervallo all'interno del testo contenuto in una forma.

slides/selection/selection.gs
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape = slide.getPageElements()[0].asShape();
shape.getText().setText("Hello");
// Range selection: Select the text range 'He'.
shape.getText().getRange(0, 2).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = shape
// selection.getTextRange().getStartIndex() = 0
// selection.getTextRange().getEndIndex() = 2
//

Selezione del cursore in una forma

Il seguente esempio mostra come effettuare una selezione del cursore all'interno del testo contenuto in una forma.

slides/selection/selection.gs
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape = slide.getPageElements()[0].asShape();
shape.getText().setText("Hello");
// Cursor selection: Place the cursor after 'H' like 'H|ello'.
shape.getText().getRange(1, 1).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = shape
// selection.getTextRange().getStartIndex() = 1
// selection.getTextRange().getEndIndex() = 1
//

Selezione dell'intervallo in una cella di una tabella

Il seguente esempio mostra come effettuare una selezione di intervallo all'interno del testo contenuto in una cella della tabella.

slides/selection/selection.gs
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const table = slide.getPageElements()[0].asTable();
const tableCell = table.getCell(0, 1);
tableCell.getText().setText("Hello");
// Range selection: Select the text range 'He'.
tableCell.getText().getRange(0, 2).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = table
// selection.getTableCellRange().getTableCells()[0] = tableCell
// selection.getTextRange().getStartIndex() = 0
// selection.getTextRange().getEndIndex() = 2
//

Selezione del cursore in TableCell

L'esempio seguente mostra come effettuare una selezione del cursore all'interno del testo contenuto in una cella della tabella.

slides/selection/selection.gs
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const table = slide.getPageElements()[0].asTable();
const tableCell = table.getCell(0, 1);
tableCell.getText().setText("Hello");
// Cursor selection: Place the cursor after 'H' like 'H|ello'.
tableCell.getText().getRange(1, 1).select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = table
// selection.getTableCellRange().getTableCells()[0] = tableCell
// selection.getTextRange().getStartIndex() = 1
// selection.getTextRange().getEndIndex() = 1
//

Trasformazione della selezione con modifiche testuali

Il seguente esempio mostra come la selezione può essere trasformata modificando il testo selezionato.

slides/selection/selection.gs
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape = slide.getPageElements()[0].asShape();
const textRange = shape.getText();
textRange.setText("World");
// Select all the text 'World'.
textRange.select();
// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = shape
// selection.getTextRange().getStartIndex() = 0
// selection.getTextRange().getEndIndex() = 6
//
// Add some text to the shape, and the selection will be transformed.
textRange.insertText(0, "Hello ");

// State of selection
//
// selection.getSelectionType() = SlidesApp.SelectionType.TEXT
// selection.getCurrentPage() = slide
// selection.getPageElementRange().getPageElements()[0] = shape
// selection.getTextRange().getStartIndex() = 0
// selection.getTextRange().getEndIndex() = 12
//

Deseleziona

Non esistono metodi espliciti per deselezionare testo o elementi della pagina. Tuttavia, questo risultato può essere ottenuto utilizzando i metodi Page.selectAsCurrentPage() o pageElement.select().

Selezionare una pagina corrente

L'esempio seguente mostra come deselezionare le selezioni correnti in una pagina impostando la pagina come pagina corrente.

slides/selection/selection.gs
// Unselect one or more page elements already selected.
//
// In case one or more page elements in the first slide are selected, setting the
// same (or any other) slide page as the current page would do the unselect.
//
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();

Seleziona un elemento della pagina

L'esempio seguente mostra come deselezionare le selezioni correnti in una pagina selezionando un elemento della pagina, rimuovendo così tutti gli altri elementi dalla selezione.

slides/selection/selection.gs
// Unselect one or more page elements already selected.
//
// In case one or more page elements in the first slide are selected,
// selecting any pageElement in the first slide (or any other pageElement) would
// do the unselect and select that pageElement.
//
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.getPageElements()[0].select();