Un PageElement
che rappresenta una linea.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
alignOnPage(alignmentPosition) | Line | Allinea l'elemento alla posizione di allineamento specificata nella pagina. |
bringForward() | Line | Porta l'elemento della pagina in primo piano nella pagina di un elemento. |
bringToFront() | Line | Porta l'elemento della pagina in primo piano. |
duplicate() | PageElement | Duplica l'elemento della pagina. |
getConnectionSites() | ConnectionSite[] | Restituisce l'elenco di ConnectionSite nell'elemento di pagina o un elenco vuoto se l'elemento di pagina non ha siti di connessione. |
getDashStyle() | DashStyle | Recupera il DashStyle della riga. |
getDescription() | String | Restituisce la descrizione del testo alternativo dell'elemento della pagina. |
getEnd() | Point | Restituisce il punto finale della linea, misurato dall'angolo in alto a sinistra della pagina. |
getEndArrow() | ArrowStyle | Recupera il ArrowStyle della freccia alla fine della riga. |
getEndConnection() | ConnectionSite | Restituisce la connessione alla fine della riga o null se non è presente alcuna connessione. |
getHeight() | Number | Restituisce l'altezza dell'elemento in punti, ovvero l'altezza del suo riquadro delimitante quando l'elemento non è ruotato. |
getInherentHeight() | Number | Restituisce l'altezza intrinseca dell'elemento in punti. |
getInherentWidth() | Number | Restituisce la larghezza intrinseca dell'elemento in punti. |
getLeft() | Number | Restituisce la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato. |
getLineCategory() | LineCategory | Recupera il LineCategory della riga. |
getLineFill() | LineFill | Recupera il LineFill della riga. |
getLineType() | LineType | Recupera il LineType della riga. |
getLink() | Link | Restituisce Link o null se non è presente alcun collegamento. |
getObjectId() | String | Restituisce l'ID univoco di questo oggetto. |
getPageElementType() | PageElementType | Restituisce il tipo di elemento della pagina, rappresentato come enum PageElementType . |
getParentGroup() | Group | Restituisce il gruppo a cui appartiene questo elemento di pagina o null se l'elemento non fa parte di un gruppo. |
getParentPage() | Page | Restituisce la pagina in cui si trova questo elemento di pagina. |
getRotation() | Number | Restituisce l'angolo di rotazione in senso orario dell'elemento attorno al suo centro in gradi, dove zero gradi significa nessuna rotazione. |
getStart() | Point | Restituisce il punto di inizio della linea, misurato dall'angolo in alto a sinistra della pagina. |
getStartArrow() | ArrowStyle | Recupera il ArrowStyle della freccia all'inizio della riga. |
getStartConnection() | ConnectionSite | Restituisce la connessione all'inizio della riga o null se non è presente alcuna connessione. |
getTitle() | String | Restituisce il titolo del testo alternativo dell'elemento della pagina. |
getTop() | Number | Restituisce la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato. |
getTransform() | AffineTransform | Restituisce la trasformazione dell'elemento della pagina. |
getWeight() | Number | Restituisce lo spessore della linea in punti. |
getWidth() | Number | Restituisce la larghezza dell'elemento in punti, ovvero la larghezza del suo riquadro delimitante quando l'elemento non è ruotato. |
isConnector() | Boolean | Restituisce true se la riga è un connettore o false in caso contrario. |
preconcatenateTransform(transform) | Line | Preconcatenate la trasformazione fornita alla trasformazione esistente dell'elemento della pagina. |
remove() | void | Rimuove l'elemento della pagina. |
removeLink() | void | Rimuove un Link . |
reroute() | Line | Reindirizza l'inizio e la fine della linea ai due punti di connessione più vicini negli elementi della pagina collegati. |
scaleHeight(ratio) | Line | Scala l'altezza dell'elemento in base al rapporto specificato. |
scaleWidth(ratio) | Line | Scala la larghezza dell'elemento in base al rapporto specificato. |
select() | void | Consente di selezionare solo il PageElement nella presentazione attiva e di rimuovere qualsiasi selezione precedente. |
select(replace) | void | Consente di selezionare PageElement nella presentazione attiva. |
sendBackward() | Line | Spostalo indietro di un elemento nella pagina. |
sendToBack() | Line | Invia l'elemento della pagina in fondo alla pagina. |
setDashStyle(style) | Line | Imposta il DashStyle della linea. |
setDescription(description) | Line | Imposta la descrizione del testo alternativo dell'elemento della pagina. |
setEnd(left, top) | Line | Imposta la posizione del punto finale della linea. |
setEnd(point) | Line | Imposta la posizione del punto finale della linea. |
setEndArrow(style) | Line | Imposta l'angolo ArrowStyle della freccia alla fine della linea. |
setEndConnection(connectionSite) | Line | Imposta la connessione alla fine della riga. |
setHeight(height) | Line | Imposta l'altezza dell'elemento in punti, ovvero l'altezza del suo riquadro delimitante quando l'elemento non è ruotato. |
setLeft(left) | Line | Imposta la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato. |
setLineCategory(lineCategory) | Line | Imposta il LineCategory della linea. |
setLinkSlide(slideIndex) | Link | Imposta un Link per il Slide specificato utilizzando l'indice a partire da zero della diapositiva. |
setLinkSlide(slide) | Link | Imposta un Link sul Slide specificato. Il link viene impostato in base all'ID slide specificato. |
setLinkSlide(slidePosition) | Link | Imposta un Link sul Slide specificato utilizzando la posizione relativa della diapositiva. |
setLinkUrl(url) | Link | Imposta un Link sulla stringa URL non vuota specificata. |
setRotation(angle) | Line | Imposta l'angolo di rotazione in senso orario dell'elemento attorno al suo centro in gradi. |
setStart(left, top) | Line | Imposta la posizione del punto di inizio della linea. |
setStart(point) | Line | Imposta la posizione del punto di inizio della linea. |
setStartArrow(style) | Line | Imposta il ArrowStyle della freccia all'inizio della riga. |
setStartConnection(connectionSite) | Line | Imposta la connessione all'inizio della riga. |
setTitle(title) | Line | Imposta il titolo del testo alternativo dell'elemento della pagina. |
setTop(top) | Line | Imposta la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato. |
setTransform(transform) | Line | Imposta la trasformazione dell'elemento della pagina con la trasformazione fornita. |
setWeight(points) | Line | Imposta lo spessore della linea in punti. |
setWidth(width) | Line | Imposta la larghezza dell'elemento in punti, ovvero la larghezza del suo riquadro delimitante quando l'elemento non è ruotato. |
Documentazione dettagliata
alignOnPage(alignmentPosition)
Allinea l'elemento alla posizione di allineamento specificata nella pagina.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
alignmentPosition | AlignmentPosition | La posizione in base alla quale allineare questo elemento della pagina. |
Invio
Line
: questo elemento della pagina, per l'accodamento.
bringForward()
Porta l'elemento della pagina in primo piano nella pagina di un elemento.
L'elemento pagina non deve essere in un gruppo.
Invio
Line
: questo elemento della pagina, per l'accodamento.
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
bringToFront()
Porta l'elemento della pagina in primo piano.
L'elemento pagina non deve essere in un gruppo.
Invio
Line
: questo elemento della pagina, per l'accodamento.
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
duplicate()
Duplica l'elemento della pagina.
L'elemento pagina duplicato viene inserito nella stessa pagina e nella stessa posizione dell'originale.
Invio
PageElement
: il nuovo elemento duplicato della pagina.
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
getConnectionSites()
Restituisce l'elenco di ConnectionSite
nell'elemento di pagina o un elenco vuoto se l'elemento di pagina non ha siti di connessione.
Invio
ConnectionSite[]
: l'elenco dei siti di connessione, che può essere vuoto se questo elemento non ha siti di connessione.
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
getDashStyle()
Recupera il DashStyle
della riga.
Invio
DashStyle
: lo stile dei trattini utilizzati con questa riga.
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
getDescription()
Restituisce la descrizione del testo alternativo dell'elemento della pagina. La descrizione viene combinata con il titolo per visualizzare e leggere il testo alternativo.
Invio
String
: la descrizione del testo alternativo dell'elemento della pagina.
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
getEnd()
Restituisce il punto finale della linea, misurato dall'angolo in alto a sinistra della pagina.
Invio
Point
: il punto di fine della riga.
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
getEndArrow()
Recupera il ArrowStyle
della freccia alla fine della riga.
Invio
ArrowStyle
: lo stile della freccia alla fine di questa riga.
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
getEndConnection()
Restituisce la connessione alla fine della riga o null
se non è presente alcuna connessione.
Invio
ConnectionSite
: la connessione alla fine della riga.
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
getHeight()
Restituisce l'altezza dell'elemento in punti, ovvero l'altezza del suo riquadro delimitante quando l'elemento non è ruotato.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limitazioni di ridimensionamento e posizionamento.
Invio
Number
: l'altezza intrinseca dell'elemento di pagina in punti oppure null
se l'elemento di pagina non ha un'altezza.
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
getInherentHeight()
Restituisce l'altezza intrinseca dell'elemento in punti.
La trasformazione dell'elemento di pagina è relativa alle sue dimensioni intrinseche. Utilizza le dimensioni intrinseche in combinazione con la trasformazione dell'elemento per determinare l'aspetto visivo finale dell'elemento.
Invio
Number
: l'altezza intrinseca dell'elemento di pagina in punti oppure null
se l'elemento di pagina non ha un'altezza.
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
getInherentWidth()
Restituisce la larghezza intrinseca dell'elemento in punti.
La trasformazione dell'elemento di pagina è relativa alle sue dimensioni intrinseche. Utilizza le dimensioni intrinseche in combinazione con la trasformazione dell'elemento per determinare l'aspetto visivo finale dell'elemento.
Invio
Number
: la larghezza intrinseca dell'elemento di pagina in punti oppure null
se l'elemento di pagina non ha larghezza.
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
getLeft()
Restituisce la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
Invio
Number
: la posizione orizzontale dell'elemento in punti, dall'angolo in alto a sinistra della pagina.
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
getLineCategory()
Recupera il LineCategory
della riga.
Invio
LineCategory
: la categoria della riga.
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
getLineFill()
Recupera il LineFill
della riga.
Invio
LineFill
: l'impostazione di riempimento di questa riga.
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
getLineType()
getLink()
Restituisce Link
o null
se non è presente alcun collegamento.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const link = shape.getLink(); if (link != null) { Logger.log(`Shape has a link of type: ${link.getLinkType()}`); }
Invio
Link
: Link
o null
se non è presente alcun link.
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
getObjectId()
Restituisce l'ID univoco di questo oggetto. Gli ID oggetto utilizzati dalle pagine e dagli elementi della pagina condividono lo stesso spazio dei nomi.
Invio
String
: l'ID univoco di questo oggetto.
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
getPageElementType()
Restituisce il tipo di elemento della pagina, rappresentato come enum PageElementType
.
Invio
PageElementType
: il tipo di elemento pagina.
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
getParentGroup()
Restituisce il gruppo a cui appartiene questo elemento di pagina o null
se l'elemento non fa parte di un gruppo.
Invio
Group
: il gruppo a cui appartiene questo elemento della pagina o 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
getParentPage()
Restituisce la pagina in cui si trova questo elemento di pagina.
Invio
Page
: la pagina in cui si trova l'elemento.
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
getRotation()
Restituisce l'angolo di rotazione in senso orario dell'elemento attorno al suo centro in gradi, dove zero gradi significa nessuna rotazione.
Invio
Number
: l'angolo di rotazione in gradi compreso tra 0 (incluso) e 360 (escluso).
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
getStart()
Restituisce il punto di inizio della linea, misurato dall'angolo in alto a sinistra della pagina.
Invio
Point
: il punto di partenza della riga.
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
getStartArrow()
Recupera il ArrowStyle
della freccia all'inizio della riga.
Invio
ArrowStyle
: lo stile della freccia all'inizio di questa riga.
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
getStartConnection()
Restituisce la connessione all'inizio della riga o null
se non è presente alcuna connessione.
Invio
ConnectionSite
: la connessione all'inizio della riga.
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
getTitle()
Restituisce il titolo del testo alternativo dell'elemento della pagina. Il titolo viene combinato con la descrizione per visualizzare e leggere il testo alternativo.
Invio
String
: il titolo del testo alternativo dell'elemento della pagina.
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
getTop()
Restituisce la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
Invio
Number
: la posizione verticale dell'elemento in punti, dall'angolo in alto a sinistra della pagina.
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
getTransform()
Restituisce la trasformazione dell'elemento della pagina.
L'aspetto visivo dell'elemento della pagina è determinato dalla sua trasformazione assoluta. Per calcolare la trasformazione assoluta, preconcatena la trasformazione di un elemento di pagina con le trasformazioni di tutti i relativi gruppi principali. Se l'elemento della pagina non è in un gruppo, la sua trasformazione assoluta è uguale al valore in questo campo.
Invio
AffineTransform
: la trasformazione dell'elemento della pagina.
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
getWeight()
Restituisce lo spessore della linea in punti.
Invio
Number
: lo spessore della linea in punti.
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
getWidth()
Restituisce la larghezza dell'elemento in punti, ovvero la larghezza del suo riquadro delimitante quando l'elemento non è ruotato.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limitazioni di ridimensionamento e posizionamento.
Invio
Number
: la larghezza intrinseca dell'elemento di pagina in punti oppure null
se l'elemento di pagina non ha larghezza.
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
isConnector()
Restituisce true
se la riga è un connettore o false
in caso contrario.
Il connettore è un tipo di linea che viene utilizzato per collegare i siti di connessione negli elementi di pagina applicabili. Ogni estremità del connettore può essere collegata a un massimo di un sito di connessione.
Invio
Boolean
: True
se la riga è un connettore o false
in caso contrario.
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
preconcatenateTransform(transform)
Preconcatenate la trasformazione fornita alla trasformazione esistente dell'elemento della pagina.
newTransform = argument * existingTransform;
Ad esempio, per spostare gli elementi di una pagina di 36 punti a sinistra:
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
Puoi anche sostituire la trasformazione dell'elemento della pagina con setTransform(transform)
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
transform | AffineTransform | La trasformazione da preconcatenare alla trasformazione dell'elemento di pagina. |
Invio
Line
: questo elemento della pagina, per l'accodamento.
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
remove()
Rimuove l'elemento della pagina.
Se dopo un'operazione di rimozione un Group
contiene solo uno o nessun elemento di pagina, viene rimosso anche il gruppo stesso.
Se un segnaposto PageElement
viene rimosso in un modello o in un layout, vengono rimossi anche gli eventuali segnaposto ereditati vuoti.
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
removeLink()
Rimuove un Link
.
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
reroute()
Reindirizza l'inizio e la fine della linea ai due punti di connessione più vicini negli elementi della pagina collegati. L'inizio e la fine della riga devono essere collegati a elementi di pagina diversi.
Invio
Line
: la riga.
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
scaleHeight(ratio)
Scala l'altezza dell'elemento in base al rapporto specificato. L'altezza dell'elemento corrisponde all'altezza del suo bounding box quando l'elemento non è ruotato.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limitazioni di ridimensionamento e posizionamento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
ratio | Number | Il rapporto per scalare l'altezza di questo elemento della pagina. |
Invio
Line
: questo elemento della pagina, per l'accodamento.
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
scaleWidth(ratio)
Scala la larghezza dell'elemento in base al rapporto specificato. La larghezza dell'elemento corrisponde alla larghezza del suo bounding box quando l'elemento non è ruotato.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limitazioni di ridimensionamento e posizionamento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
ratio | Number | Il rapporto per scalare la larghezza di questo elemento della pagina. |
Invio
Line
: questo elemento della pagina, per l'accodamento.
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
select()
Consente di selezionare solo il PageElement
nella presentazione attiva e di rimuovere qualsiasi selezione precedente. È come chiamare select(replace)
con true
.
Uno script può accedere alla selezione dell'utente che lo esegue solo se è legato alla presentazione.
In questo modo, il Page
principale del PageElement
viene impostato come current page selection
.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
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
select(replace)
Consente di selezionare PageElement
nella presentazione attiva.
Uno script può accedere alla selezione dell'utente che lo esegue solo se è legato alla presentazione.
Passa true
a questo metodo per selezionare solo PageElement
e rimuovere eventuali selezione precedenti. Viene impostato anche il Page
principale del PageElement
come
current page selection
.
Passa false
per selezionare più oggetti PageElement
. Gli oggetti PageElement
devono trovarsi nello stesso Page
.
Quando selezioni un elemento della pagina utilizzando un parametro false
, devono essere soddisfatte le seguenti condizioni:
- L'elemento
Page
principale dell'oggettoPageElement
deve esserecurrent page selection
. - Non devono essere selezionati più oggetti
Page
.
Per assicurarti che sia così, l'approccio preferito è selezionare prima l'elemento principale Page
utilizzando Page.selectAsCurrentPage()
e poi gli elementi della pagina in quella pagina.
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); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
replace | Boolean | Se true , la selezione sostituisce qualsiasi selezione precedente; altrimenti la selezione viene aggiunta a qualsiasi selezione precedente. |
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
sendBackward()
Spostalo indietro di un elemento nella pagina.
L'elemento pagina non deve essere in un gruppo.
Invio
Line
: questo elemento della pagina, per l'accodamento.
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
sendToBack()
Invia l'elemento della pagina in fondo alla pagina.
L'elemento pagina non deve essere in un gruppo.
Invio
Line
: questo elemento della pagina, per l'accodamento.
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
setDashStyle(style)
Imposta il DashStyle
della linea.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
style | DashStyle | Lo stile dei trattini da impostare per questa riga. |
Invio
Line
: questa riga, per l'accodamento.
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
setDescription(description)
Imposta la descrizione del testo alternativo dell'elemento della pagina.
Il metodo non è supportato per gli elementi Group
.
// Set the first page element's alt text description to "new alt text // description". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
description | String | La stringa a cui impostare la descrizione del testo alternativo. |
Invio
Line
: questo elemento della pagina.
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
setEnd(left, top)
Imposta la posizione del punto finale della linea.
Il percorso della linea può essere modificato dopo la modifica della posizione.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
left | Number | La posizione orizzontale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
top | Number | La posizione verticale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
Invio
Line
: questa riga, per l'accodamento.
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
setEnd(point)
Imposta la posizione del punto finale della linea.
Il percorso della linea può essere modificato dopo la modifica della posizione.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
point | Point | Il punto finale della linea, la cui posizione viene misurata dall'angolo in alto a sinistra della pagina. |
Invio
Line
: questa riga, per l'accodamento.
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
setEndArrow(style)
Imposta l'angolo ArrowStyle
della freccia alla fine della linea.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
style | ArrowStyle | Lo stile da impostare. |
Invio
Line
: questa riga, per l'accodamento.
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
setEndConnection(connectionSite)
Imposta la connessione alla fine della riga. Sposta la fine della riga al sito di connessione specificato mantenendo invariata l'altra estremità.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
connectionSite | ConnectionSite | Il sito di connessione a cui viene aggiornato il collegamento finale o null se viene rimosso il collegamento finale. |
Invio
Line
: la riga.
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
setHeight(height)
Imposta l'altezza dell'elemento in punti, ovvero l'altezza del suo riquadro delimitante quando l'elemento non è ruotato.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limitazioni di ridimensionamento e posizionamento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
height | Number | La nuova altezza dell'elemento della pagina da impostare, in punti. |
Invio
Line
: questo elemento della pagina, per l'accodamento.
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
setLeft(left)
Imposta la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
left | Number | La nuova posizione orizzontale da impostare, in punti. |
Invio
Line
: questo elemento della pagina, per l'accodamento.
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
setLineCategory(lineCategory)
Imposta il LineCategory
della linea.
Puoi impostare la categoria solo su connectors
. Il connettore potrebbe essere reindirizzato dopo la modifica della categoria.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
lineCategory | LineCategory | La categoria della riga da impostare. |
Invio
Line
: la riga.
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
setLinkSlide(slideIndex)
Imposta un Link
per il Slide
specificato utilizzando l'indice a partire da zero della diapositiva.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(0);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
slideIndex | Integer | L'indice della diapositiva basato su zero. |
Invio
Link
: il valore Link
impostato.
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
setLinkSlide(slide)
Imposta un Link
sul Slide
specificato. Il link viene impostato in base all'ID slide specificato.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(slides[0]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
slide | Slide | L'Slide da collegare. |
Invio
Link
: il valore Link
impostato.
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
setLinkSlide(slidePosition)
Imposta un Link
sul Slide
specificato utilizzando la posizione relativa della diapositiva.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
slidePosition | SlidePosition | Il SlidePosition relativo. |
Invio
Link
: il valore Link
impostato.
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
setLinkUrl(url)
Imposta un Link
sulla stringa URL non vuota specificata.
// Set a link to the URL. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkUrl('https://slides.google.com');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
url | String | La stringa dell'URL. |
Invio
Link
: il valore Link
impostato.
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
setRotation(angle)
Imposta l'angolo di rotazione in senso orario dell'elemento attorno al suo centro in gradi.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limitazioni di ridimensionamento e posizionamento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
angle | Number | Il nuovo angolo di rotazione in senso orario da impostare, in gradi. |
Invio
Line
: questo elemento della pagina, per l'accodamento.
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
setStart(left, top)
Imposta la posizione del punto di inizio della linea.
Il percorso della linea può essere modificato dopo la modifica della posizione.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
left | Number | La posizione orizzontale del punto di inizio della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
top | Number | La posizione verticale del punto di inizio della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
Invio
Line
: questa riga, per l'accodamento.
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
setStart(point)
Imposta la posizione del punto di inizio della linea.
Il percorso della linea può essere modificato dopo la modifica della posizione.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
point | Point | Il punto di inizio della linea, la cui posizione viene misurata dall'angolo in alto a sinistra della pagina. |
Invio
Line
: questa riga, per l'accodamento.
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
setStartArrow(style)
Imposta il ArrowStyle
della freccia all'inizio della riga.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
style | ArrowStyle | Il nuovo stile di freccia da impostare. |
Invio
Line
: questa riga, per l'accodamento.
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
setStartConnection(connectionSite)
Imposta la connessione all'inizio della riga. Sposta l'inizio della riga al sito di connessione specificato mantenendo invariata l'altra estremità.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
connectionSite | ConnectionSite | Il sito di connessione a cui viene aggiornato il collegamento iniziale o null
se viene rimosso il collegamento iniziale. |
Invio
Line
: la riga.
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
setTitle(title)
Imposta il titolo del testo alternativo dell'elemento della pagina.
Il metodo non è supportato per gli elementi Group
.
// Set the first page element's alt text title to "new alt text title". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
title | String | La stringa a cui impostare il titolo del testo alternativo. |
Invio
Line
: questo elemento della pagina.
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
setTop(top)
Imposta la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
top | Number | La nuova posizione verticale da impostare, in punti. |
Invio
Line
: questo elemento della pagina, per l'accodamento.
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
setTransform(transform)
Imposta la trasformazione dell'elemento della pagina con la trasformazione fornita.
L'aggiornamento della trasformazione di un gruppo modifica la trasformazione assoluta degli elementi della pagina al suo interno, il che può cambiare il loro aspetto visivo.
L'aggiornamento della trasformazione di un elemento di pagina all'interno di un gruppo modifica solo la trasformazione di quell'elemento, senza influire sulle trasformazioni del gruppo o di altri elementi di pagina al suo interno.
Per informazioni dettagliate su come le trasformazioni influiscono sull'aspetto visivo degli elementi della pagina, vedi getTransform()
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
transform | AffineTransform | La trasformazione impostata per questo elemento della pagina. |
Invio
Line
: questo elemento, per l'accodamento.
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
setWeight(points)
Imposta lo spessore della linea in punti.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
points | Number | Il nuovo spessore della linea in punti. |
Invio
Line
: questa riga, per l'accodamento.
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
setWidth(width)
Imposta la larghezza dell'elemento in punti, ovvero la larghezza del suo riquadro delimitante quando l'elemento non è ruotato.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limitazioni di ridimensionamento e posizionamento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
width | Number | La nuova larghezza di questo elemento di pagina da impostare, in punti. |
Invio
Line
: questo elemento della pagina, per l'accodamento.
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