Class Line

Linea

Un PageElement che rappresenta una linea.

Metodi

MetodoTipo restituitoBreve descrizione
alignOnPage(alignmentPosition)LineAllinea l'elemento alla posizione di allineamento specificata nella pagina.
bringForward()LinePorta in avanti l'elemento di pagina nella pagina di un elemento.
bringToFront()LinePorta l'elemento di pagina in primo piano.
duplicate()PageElementDuplica l'elemento di 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()DashStyleRecupera il valore DashStyle della linea.
getDescription()StringRestituisce la descrizione del testo alternativo dell'elemento di pagina.
getEnd()PointRestituisce il punto finale della linea, misurato nell'angolo superiore sinistro della pagina.
getEndArrow()ArrowStyleRecupera il valore ArrowStyle della freccia alla fine della linea.
getEndConnection()ConnectionSiteRestituisce la connessione alla fine della riga o null in assenza di connessione.
getHeight()NumberRestituisce l'altezza in punti dell'elemento, ovvero l'altezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.
getInherentHeight()NumberRestituisce l'altezza intrinseca in punti dell'elemento.
getInherentWidth()NumberRestituisce la larghezza intrinseca in punti dell'elemento.
getLeft()NumberRestituisce la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione.
getLineCategory()LineCategoryRecupera il valore LineCategory della linea.
getLineFill()LineFillRecupera il valore LineFill della linea.
getLineType()LineTypeRecupera il valore LineType della linea.
getLink()LinkRestituisce Link o null in assenza di link.
getObjectId()StringRestituisce l'ID univoco dell'oggetto.
getPageElementType()PageElementTypeRestituisce il tipo di elemento di pagina, rappresentato da un'enumerazione PageElementType.
getParentGroup()GroupRestituisce il gruppo a cui appartiene questo elemento di pagina oppure null se l'elemento non si trova in un gruppo.
getParentPage()PageRestituisce la pagina in cui si trova questo elemento di pagina.
getRotation()NumberRestituisce l'angolo di rotazione in senso orario dell'elemento in gradi intorno al suo centro, dove zero gradi indica che non c'è rotazione.
getStart()PointRestituisce il punto iniziale della linea, misurato dall'angolo superiore sinistro della pagina.
getStartArrow()ArrowStyleRecupera il punto ArrowStyle della freccia all'inizio della riga.
getStartConnection()ConnectionSiteRestituisce la connessione all'inizio della riga o null in assenza di connessione.
getTitle()StringRestituisce il titolo del testo alternativo dell'elemento di pagina.
getTop()NumberRestituisce la posizione verticale dell'elemento in punti, misurata dall'angolo superiore sinistro della pagina quando l'elemento non ha rotazione.
getTransform()AffineTransformRestituisce la trasformazione dell'elemento di pagina.
getWeight()NumberRestituisce lo spessore della linea in punti.
getWidth()NumberRestituisce la larghezza in punti dell'elemento, ovvero la larghezza del riquadro di delimitazione dell'elemento quando quest'ultimo non ha rotazione.
isConnector()BooleanRestituisce true se la riga è un connettore oppure false in caso contrario.
preconcatenateTransform(transform)LinePreconcatena la trasformazione fornita alla trasformazione esistente dell'elemento della pagina.
remove()voidRimuove l'elemento della pagina.
removeLink()voidRimuove un Link.
reroute()LineReindirizza l'inizio e la fine della linea ai due siti di connessione più vicini sugli elementi della pagina collegati.
scaleHeight(ratio)LineScala l'altezza dell'elemento in base al rapporto specificato.
scaleWidth(ratio)LineScala la larghezza dell'elemento in base al rapporto specificato.
select()voidSeleziona solo PageElement nella presentazione attiva e rimuove eventuali selezioni precedenti.
select(replace)voidSeleziona PageElement nella presentazione attiva.
sendBackward()LineInvia l'elemento di pagina indietro di un elemento nella pagina.
sendToBack()LineInvia l'elemento della pagina in fondo alla pagina.
setDashStyle(style)LineImposta il valore DashStyle della linea.
setDescription(description)LineImposta la descrizione del testo alternativo dell'elemento di pagina.
setEnd(left, top)LineImposta la posizione del punto finale della linea.
setEnd(point)LineImposta la posizione del punto finale della linea.
setEndArrow(style)LineImposta il ArrowStyle della freccia alla fine della linea.
setEndConnection(connectionSite)LineImposta la connessione alla fine della riga.
setHeight(height)LineImposta l'altezza dell'elemento in punti, ovvero l'altezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.
setLeft(left)LineImposta la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione.
setLineCategory(lineCategory)LineImposta il valore LineCategory della linea.
setLinkSlide(slideIndex)LinkImposta un Link sul valore Slide specificato utilizzando l'indice in base zero della slide.
setLinkSlide(slide)LinkImposta un Link sul valore Slide specificato. Il collegamento viene impostato dall'ID slide specificato.
setLinkSlide(slidePosition)LinkImposta un Link sul valore Slide specificato utilizzando la posizione relativa della slide.
setLinkUrl(url)LinkImposta un valore Link sulla stringa URL non vuota specificata.
setRotation(angle)LineImposta l'angolo di rotazione in senso orario dell'elemento intorno al suo centro in gradi.
setStart(left, top)LineImposta la posizione del punto iniziale della linea.
setStart(point)LineImposta la posizione del punto iniziale della linea.
setStartArrow(style)LineImposta il ArrowStyle della freccia all'inizio della linea.
setStartConnection(connectionSite)LineImposta la connessione all'inizio della riga.
setTitle(title)LineImposta il titolo del testo alternativo dell'elemento di pagina.
setTop(top)LineImposta la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione.
setTransform(transform)LineImposta la trasformazione dell'elemento della pagina con la trasformazione fornita.
setWeight(points)LineImposta lo spessore della linea in punti.
setWidth(width)LineImposta la larghezza dell'elemento in punti, ovvero la larghezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.

Documentazione dettagliata

alignOnPage(alignmentPosition)

Allinea l'elemento alla posizione di allineamento specificata nella pagina.

Parametri

NomeTipoDescrizione
alignmentPositionAlignmentPositionLa posizione a cui allineare questo elemento di pagina sulla pagina.

Ritorni

Line: elemento di pagina per il concatenamento.


bringForward()

Porta in avanti l'elemento di pagina nella pagina di un elemento.

L'elemento di pagina non deve essere in un gruppo.

Ritorni

Line: elemento di pagina per il concatenamento.

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 di pagina in primo piano.

L'elemento di pagina non deve essere in un gruppo.

Ritorni

Line: elemento di pagina per il concatenamento.

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 di pagina.

L'elemento di pagina duplicato viene posizionato sulla stessa pagina e nella stessa posizione dell'originale.

Ritorni

PageElement: il nuovo duplicato di questo elemento di 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.

Ritorni

ConnectionSite[]: l'elenco dei siti di connessione, che potrebbe 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 valore DashStyle della linea.

Ritorni

DashStyle: lo stile del tratteggio utilizzato con questa linea.

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 di pagina. La descrizione viene combinata con il titolo da mostrare e leggere il testo alternativo.

Ritorni

String: la descrizione del testo alternativo dell'elemento di 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 nell'angolo superiore sinistro della pagina.

Ritorni

Point: il punto finale della linea.

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 valore ArrowStyle della freccia alla fine della linea.

Ritorni

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 in assenza di connessione.

Ritorni

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 in punti dell'elemento, ovvero l'altezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.

Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi di pagina non sono compatibili con questo metodo, consulta le limitazioni relative a dimensioni e posizionamento.

Ritorni

Number: l'altezza intrinseca in punti dell'elemento di pagina o null se l'elemento della 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 in punti dell'elemento.

La trasformazione dell'elemento della pagina è relativa alle sue dimensioni intrinseche. Utilizza la dimensione intrinseca in combinazione con la trasformazione dell'elemento per determinare l'aspetto visivo finale dell'elemento.

Ritorni

Number: l'altezza intrinseca in punti dell'elemento di pagina o null se l'elemento della 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 in punti dell'elemento.

La trasformazione dell'elemento della pagina è relativa alle sue dimensioni intrinseche. Utilizza la dimensione intrinseca in combinazione con la trasformazione dell'elemento per determinare l'aspetto visivo finale dell'elemento.

Ritorni

Number: la larghezza intrinseca in punti dell'elemento della pagina o null se l'elemento della pagina non ha una 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 ha rotazione.

Ritorni

Number: posizione orizzontale di questo 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 valore LineCategory della linea.

Ritorni

LineCategory: la categoria della linea.

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 valore LineFill della linea.

Ritorni

LineFill: l'impostazione di riempimento 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

getLineType()

Recupera il valore LineType della linea.

Ritorni

LineType: il tipo 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

Restituisce Link o null in assenza di link.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Ritorni

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 dell'oggetto. Gli ID oggetto utilizzati da pagine ed elementi di pagina condividono lo stesso spazio dei nomi.

Ritorni

String: l'ID univoco dell'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 di pagina, rappresentato da un'enumerazione PageElementType.

Ritorni

PageElementType: il tipo di 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

getParentGroup()

Restituisce il gruppo a cui appartiene questo elemento di pagina oppure null se l'elemento non si trova in un gruppo.

Ritorni

Group: il gruppo a cui appartiene questo elemento di 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.

Ritorni

Page: la pagina in cui si trova questo 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 in gradi intorno al suo centro, dove zero gradi indica che non c'è rotazione.

Ritorni

Number: l'angolo di rotazione espresso in gradi compresi 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 iniziale della linea, misurato dall'angolo superiore sinistro della pagina.

Ritorni

Point: il punto di partenza della linea.

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 punto ArrowStyle della freccia all'inizio della riga.

Ritorni

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 in assenza di connessione.

Ritorni

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 di pagina. Il titolo viene combinato con la descrizione per mostrare e leggere il testo alternativo.

Ritorni

String: titolo del testo alternativo dell'elemento di 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 superiore sinistro della pagina quando l'elemento non ha rotazione.

Ritorni

Number: la posizione verticale di questo 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 di 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 suoi gruppi principali. Se l'elemento di pagina non fa parte di un gruppo, la trasformazione assoluta corrisponde al valore in questo campo.

Ritorni

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.

Ritorni

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 in punti dell'elemento, ovvero la larghezza del riquadro di delimitazione dell'elemento quando quest'ultimo non ha rotazione.

Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi di pagina non sono compatibili con questo metodo, consulta le limitazioni relative a dimensioni e posizionamento.

Ritorni

Number: la larghezza intrinseca in punti dell'elemento della pagina o null se l'elemento della pagina non ha una 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 oppure false in caso contrario.

Il connettore è un tipo di riga utilizzato per collegare i siti delle connessioni sugli elementi di pagina applicabili. Ogni estremità del connettore può essere connessa al massimo a un sito di connessione.

Ritorni

Boolean: True se la linea è un connettore oppure 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)

Preconcatena 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:

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

Puoi anche sostituire la trasformazione dell'elemento di pagina con setTransform(transform).

Parametri

NomeTipoDescrizione
transformAffineTransformLa trasformazione per preconcatenare la trasformazione di questo elemento di pagina.

Ritorni

Line: elemento di pagina per il concatenamento.

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 elemento Group contiene solo uno o nessun elemento di pagina, viene rimosso anche il gruppo.

Se un segnaposto PageElement viene rimosso da uno schema o da un layout, vengono rimossi anche tutti i segnaposto ereditari 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

Rimuove un Link.

shape.removeLink();

reroute()

Reindirizza l'inizio e la fine della linea ai due siti di connessione più vicini sugli elementi della pagina collegati. L'inizio e la fine della riga devono essere collegati a elementi di pagina diversi.

Ritorni

Line: la linea.

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 è l'altezza del relativo riquadro di delimitazione quando l'elemento non ha rotazione.

Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi di pagina non sono compatibili con questo metodo, consulta le limitazioni relative a dimensioni e posizionamento.

Parametri

NomeTipoDescrizione
ratioNumberIl rapporto per cui ridimensionare l'altezza di questo elemento di pagina.

Ritorni

Line: elemento di pagina per il concatenamento.

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 è la larghezza del relativo riquadro di delimitazione quando l'elemento non ha rotazione.

Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi di pagina non sono compatibili con questo metodo, consulta le limitazioni relative a dimensioni e posizionamento.

Parametri

NomeTipoDescrizione
ratioNumberIl rapporto per cui ridimensionare la larghezza di questo elemento di pagina.

Ritorni

Line: elemento di pagina per il concatenamento.

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

Seleziona solo PageElement nella presentazione attiva e rimuove eventuali selezioni precedenti. Equivale a chiamare select(replace) con true.

Uno script può accedere solo alla selezione dell'utente che lo esegue e solo se è associato alla presentazione.

In questo modo, l'elemento Page principale di PageElement viene impostato come current page selection.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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)

Seleziona PageElement nella presentazione attiva.

Uno script può accedere solo alla selezione dell'utente che lo esegue e solo se è associato alla presentazione.

Passa true a questo metodo per selezionare solo PageElement e rimuovere eventuali selezione precedente. In questo modo viene impostato anche il Page principale di PageElement come current page selection.

Passa false per selezionare più oggetti PageElement. Gli oggetti PageElement devono trovarsi nello stesso elemento Page.

Le seguenti condizioni devono essere soddisfatte durante la selezione di un elemento di pagina utilizzando un parametro false:

  1. L'elemento Page principale dell'oggetto PageElement deve essere current page selection.
  2. Non devono essere selezionati più oggetti Page.

In questo caso, l'approccio preferito consiste nel selezionare prima l'elemento Page principale utilizzando Page.selectAsCurrentPage(), quindi selezionare gli elementi di pagina nella pagina.

var 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.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parametri

NomeTipoDescrizione
replaceBooleanSe true, la selezione sostituisce qualsiasi selezione precedente, altrimenti 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()

Invia l'elemento di pagina indietro di un elemento nella pagina.

L'elemento di pagina non deve essere in un gruppo.

Ritorni

Line: elemento di pagina per il concatenamento.

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 di pagina non deve essere in un gruppo.

Ritorni

Line: elemento di pagina per il concatenamento.

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 valore DashStyle della linea.

Parametri

NomeTipoDescrizione
styleDashStyleLo stile del tratto da impostare per questa linea.

Ritorni

Line - Questa riga, per il concatenamento.

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 di pagina.

Il metodo non è supportato per gli elementi Group.

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parametri

NomeTipoDescrizione
descriptionStringLa stringa su cui impostare il testo alternativo della descrizione.

Ritorni

Line: questo elemento di 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 il cambio di posizione.

Parametri

NomeTipoDescrizione
leftNumberLa posizione orizzontale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina.
topNumberLa posizione verticale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina.

Ritorni

Line - Questa riga, per il concatenamento.

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 il cambio di posizione.

Parametri

NomeTipoDescrizione
pointPointIl punto finale della linea, la cui posizione è misurata dall'angolo in alto a sinistra della pagina.

Ritorni

Line - Questa riga, per il concatenamento.

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 il ArrowStyle della freccia alla fine della linea.

Parametri

NomeTipoDescrizione
styleArrowStyleLo stile da impostare.

Ritorni

Line - Questa riga, per il concatenamento.

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 l'estremità della riga nel sito di connessione specificato, senza modificare l'altra estremità.

Parametri

NomeTipoDescrizione
connectionSiteConnectionSiteIl sito di connessione al quale viene aggiornata la connessione finale oppure null se viene rimossa la connessione finale.

Ritorni

Line: la linea.

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 riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.

Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi di pagina non sono compatibili con questo metodo, consulta le limitazioni relative a dimensioni e posizionamento.

Parametri

NomeTipoDescrizione
heightNumberLa nuova altezza da impostare di questo elemento di pagina, espressa in punti.

Ritorni

Line: elemento di pagina per il concatenamento.

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 ha rotazione.

Parametri

NomeTipoDescrizione
leftNumberLa nuova posizione orizzontale da impostare, in punti.

Ritorni

Line: elemento di pagina per il concatenamento.

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 valore LineCategory della linea.

Puoi impostare la categoria solo su connectors. Il connettore può essere reindirizzato dopo la modifica della categoria.

Parametri

NomeTipoDescrizione
lineCategoryLineCategoryLa categoria di linea da impostare.

Ritorni

Line: la linea.

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 sul valore Slide specificato utilizzando l'indice in base zero della slide.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Parametri

NomeTipoDescrizione
slideIndexIntegerL'indice in base zero alla slide.

Ritorni

Link: 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 valore Slide specificato. Il collegamento viene impostato dall'ID slide specificato.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Parametri

NomeTipoDescrizione
slideSlideSlide da collegare.

Ritorni

Link: 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 valore Slide specificato utilizzando la posizione relativa della slide.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Parametri

NomeTipoDescrizione
slidePositionSlidePositionIl relativo SlidePosition.

Ritorni

Link: 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 valore Link sulla stringa URL non vuota specificata.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Parametri

NomeTipoDescrizione
urlStringLa stringa dell'URL.

Ritorni

Link: 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 intorno al suo centro in gradi.

Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi di pagina non sono compatibili con questo metodo, consulta le limitazioni relative a dimensioni e posizionamento.

Parametri

NomeTipoDescrizione
angleNumberIl nuovo angolo di rotazione in senso orario da impostare, espresso in gradi.

Ritorni

Line: elemento di pagina per il concatenamento.

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 iniziale della linea.

Il percorso della linea può essere modificato dopo il cambio di posizione.

Parametri

NomeTipoDescrizione
leftNumberLa posizione orizzontale del punto iniziale della linea, misurata in punti dall'angolo in alto a sinistra della pagina.
topNumberLa posizione verticale del punto iniziale della linea, misurata in punti dall'angolo in alto a sinistra della pagina.

Ritorni

Line - Questa riga, per il concatenamento.

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 iniziale della linea.

Il percorso della linea può essere modificato dopo il cambio di posizione.

Parametri

NomeTipoDescrizione
pointPointIl punto iniziale della linea, la cui posizione è misurata dall'angolo in alto a sinistra della pagina.

Ritorni

Line - Questa riga, per il concatenamento.

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

Parametri

NomeTipoDescrizione
styleArrowStyleIl nuovo stile di freccia da impostare.

Ritorni

Line - Questa riga, per il concatenamento.

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 linea nel sito di connessione specificato, mantenendo intatta l'altra estremità.

Parametri

NomeTipoDescrizione
connectionSiteConnectionSiteIl sito di connessione a cui viene aggiornata la connessione di avvio oppure null se viene rimossa la connessione di avvio.

Ritorni

Line: la linea.

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 di pagina.

Il metodo non è supportato per gli elementi Group.

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parametri

NomeTipoDescrizione
titleStringLa stringa su cui impostare il titolo del testo alternativo.

Ritorni

Line: questo elemento di 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 ha rotazione.

Parametri

NomeTipoDescrizione
topNumberLa nuova posizione verticale da impostare, in punti.

Ritorni

Line: elemento di pagina per il concatenamento.

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 nel gruppo, che può cambiare l'aspetto visivo.

L'aggiornamento della trasformazione di un elemento di pagina che fa parte di un gruppo cambia solo la trasformazione dell'elemento in questione; non influisce sulle trasformazioni del gruppo o di altri elementi della pagina nel gruppo.

Per informazioni dettagliate sull'impatto delle trasformazioni sull'aspetto visivo degli elementi della pagina, consulta getTransform().

Parametri

NomeTipoDescrizione
transformAffineTransformLa trasformazione impostata per questo elemento di pagina.

Ritorni

Line: questo elemento per il concatenamento.

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

NomeTipoDescrizione
pointsNumberIl nuovo spessore della linea in punti.

Ritorni

Line - Questa riga, per il concatenamento.

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 riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.

Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi di pagina non sono compatibili con questo metodo, consulta le limitazioni relative a dimensioni e posizionamento.

Parametri

NomeTipoDescrizione
widthNumberLa nuova larghezza da impostare di questo elemento di pagina, espressa in punti.

Ritorni

Line: elemento di pagina per il concatenamento.

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