Per selezione si intende l'elemento selezionato in una pagina di presentazione aperta, come un intervallo di testo evidenziato o una tabella. Questa guida spiega come ottenere e impostare la selezione in una presentazione attiva utilizzando Apps Script.
La selezione è un'istantanea di ciò che era all'avvio dello script. Se l'utente clic e la selezione cambia mentre lo script è in esecuzione, queste modifiche non verrà riportato.
Selezioni e tipo di selezione
Puoi leggere la selezione utilizzando Selezione . La classe dispone di vari metodi per recuperare gli oggetti selezionati in base al tipo di 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; continua
esempio precedente, puoi recuperare la forma contenente il testo selezionato utilizzando
selection.getPageElementRange().getPageElements()[0]
. Analogamente, la pagina
contiene la forma che lo contiene è la pagina attiva corrente; a
recupera la pagina, usa selection.getCurrentPage()
.
Lettura della selezione in corso...
Per leggere la selezione, utilizza il Presentation.getSelection() come mostrato nell'esempio seguente:
Lettura della pagina corrente
Per recuperare la pagina corrente che l'utente sta visualizzando, utilizza getSelection() e getCurrentPage() come segue:
Tieni presente che la pagina corrente può essere uno dei seguenti tipi:
Nella pagina corrente possono essere selezionati uno o più oggetti e il valore SelectionType determina il tipo di selezione.
Lettura della selezione in base al tipo di selezione
L'esempio seguente mostra come utilizzare il tipo di selezione per leggere la selezione corrente in un modo appropriato.
Lettura delle selezioni del testo
Puoi leggere la selezione del testo utilizzando Metodo Selection.getTextRange(). Sono disponibili due tipi di selezione del testo:
- Selezione dell'intervallo: se una forma contiene il testo "Ciao" e "Lui". sono selezionato, l'intervallo restituito ha startIndex=0 ed endIndex=2.
- Selezione del cursore: se una forma contiene il testo "Hello" e il cursore è dopo "H" ("H|ello"), l'intervallo restituito è vuoto con startIndex=1 ed endIndex=1.
Modifica della selezione
Lo script può modificare la selezione dell'utente. Eventuali modifiche alla selezione apportate dallo script alla presentazione vengono applicate nelle operazioni di selezione successive per la durata dell'esecuzione dello script.
Le modifiche alla selezione vengono applicate al browser dell'utente solo dopo lo script
l'esecuzione viene completata o quando viene chiamato Presentation.saveAndClose()
.
Selezione della pagina corrente
Una pagina della presentazione attiva può essere selezionata come pagina corrente richiamando il metodo selectAsCurrentPage(). Questo metodo rimuove qualsiasi elemento precedente della pagina, pagina o selezione di testo. Quindi, utilizzando questo metodo nella pagina corrente consente di deselezionare le selezioni correnti nella . Ad esempio:
Selezionare un elemento di pagina
Per selezionare un elemento di pagina in una pagina, utilizza il metodo PageElement.select(). In questo modo, vengono deselezionati anche eventuali elementi della pagina selezionati in precedenza.
Ad esempio:
Selezionare più elementi di pagina
Per aggiungere altri elementi di pagina alla selezione, utilizza il Metodo PageElement.select(false). Tutti gli elementi della pagina devono trovarsi nella pagina corrente.
Trasformare la selezione
Le modifiche eseguite dallo script possono trasformare la selezione corrente, ciò che hai selezionato cambia in seguito alla modifica. Ad esempio:
- Supponi di avere selezionato due forme A e B.
- Successivamente, lo script rimuove la forma A.
- Di conseguenza, la selezione viene trasformata in base alla modifica in modo che sia selezionata la forma B.
L'esempio seguente mostra come è possibile trasformare la selezione manipolando elementi della pagina selezionati.
Selezione del testo
Il testo contenuto in una forma o in una cella di tabella può essere selezionato utilizzando il metodo TextRange.select(). Se il testo è contenuto in una forma, viene selezionata anche quella forma. Se il testo è contenuto in una cella di tabella, vengono selezionate sia la cella di tabella sia la tabella che la contiene.
In questo modo viene impostata anche la pagina principale come pagina corrente.
Selezione di un intervallo in una forma
L'esempio seguente mostra come effettuare una selezione di un intervallo all'interno del testo contenuto in una forma.
Selezione del cursore in una forma
L'esempio seguente mostra come effettuare una selezione del cursore all'interno del testo contenuto in una forma.
Selezione di intervalli in una cella di tabella
L'esempio seguente mostra come effettuare una selezione di un intervallo all'interno del testo contenuto in una cella di tabella.
Selezione del cursore in TableCell
L'esempio seguente mostra come effettuare una selezione del cursore all'interno del testo contenuto in una cella di tabella.
Trasformazione della selezione con modifiche testuali
L'esempio seguente mostra come la selezione può essere trasformata modificando testo selezionato.
Deselezione in corso...
Non sono disponibili metodi espliciti per deselezionare il testo o gli elementi della pagina. Tuttavia, questo
il risultato può essere ottenuto utilizzando l'Page.selectAsCurrentPage()
pageElement.select()
metodi.
Seleziona una pagina corrente
L'esempio seguente mostra come deselezionare le eventuali selezioni correnti in una pagina impostandola come pagina corrente.
Seleziona un elemento di pagina
L'esempio seguente mostra come deselezionare le selezioni correnti in una pagina selezionando un elemento di pagina, rimuovendo così tutti gli altri elementi dalla selezione.