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 l'elemento della pagina in primo piano nella pagina di un elemento.
bringToFront()LinePorta l'elemento della pagina in primo piano.
duplicate()PageElementDuplica 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()DashStyleRecupera il DashStyle della riga.
getDescription()StringRestituisce la descrizione del testo alternativo dell'elemento della pagina.
getEnd()PointRestituisce il punto finale della linea, misurato dall'angolo in alto a sinistra della pagina.
getEndArrow()ArrowStyleRecupera il ArrowStyle della freccia alla fine della riga.
getEndConnection()ConnectionSiteRestituisce la connessione alla fine della riga o null se non è presente alcuna connessione.
getHeight()NumberRestituisce l'altezza dell'elemento in punti, ovvero l'altezza del suo riquadro delimitante quando l'elemento non è ruotato.
getInherentHeight()NumberRestituisce l'altezza intrinseca dell'elemento in punti.
getInherentWidth()NumberRestituisce la larghezza intrinseca dell'elemento in punti.
getLeft()NumberRestituisce la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
getLineCategory()LineCategoryRecupera il LineCategory della riga.
getLineFill()LineFillRecupera il LineFill della riga.
getLineType()LineTypeRecupera il LineType della riga.
getLink()LinkRestituisce Link o null se non è presente alcun collegamento.
getObjectId()StringRestituisce l'ID univoco di questo oggetto.
getPageElementType()PageElementTypeRestituisce il tipo di elemento della pagina, rappresentato come enum PageElementType.
getParentGroup()GroupRestituisce il gruppo a cui appartiene questo elemento di pagina o null se l'elemento non fa parte di 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 attorno al suo centro in gradi, dove zero gradi significa nessuna rotazione.
getStart()PointRestituisce il punto di inizio della linea, misurato dall'angolo in alto a sinistra della pagina.
getStartArrow()ArrowStyleRecupera il ArrowStyle della freccia all'inizio della riga.
getStartConnection()ConnectionSiteRestituisce la connessione all'inizio della riga o null se non è presente alcuna connessione.
getTitle()StringRestituisce il titolo del testo alternativo dell'elemento della pagina.
getTop()NumberRestituisce la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
getTransform()AffineTransformRestituisce la trasformazione dell'elemento della pagina.
getWeight()NumberRestituisce lo spessore della linea in punti.
getWidth()NumberRestituisce la larghezza dell'elemento in punti, ovvero la larghezza del suo riquadro delimitante quando l'elemento non è ruotato.
isConnector()BooleanRestituisce true se la riga è un connettore o false in caso contrario.
preconcatenateTransform(transform)LinePreconcatenate 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 punti di connessione più vicini negli 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()voidConsente di selezionare solo il PageElement nella presentazione attiva e di rimuovere qualsiasi selezione precedente.
select(replace)voidConsente di selezionare PageElement nella presentazione attiva.
sendBackward()LineSpostalo indietro di un elemento nella pagina.
sendToBack()LineInvia l'elemento della pagina in fondo alla pagina.
setDashStyle(style)LineImposta il DashStyle della linea.
setDescription(description)LineImposta la descrizione del testo alternativo dell'elemento della 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 l'angolo 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 suo riquadro delimitante quando l'elemento non è ruotato.
setLeft(left)LineImposta la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
setLineCategory(lineCategory)LineImposta il LineCategory della linea.
setLinkSlide(slideIndex)LinkImposta un Link per il Slide specificato utilizzando l'indice a partire da zero della diapositiva.
setLinkSlide(slide)LinkImposta un Link sul Slide specificato. Il link viene impostato dall'ID slide specificato.
setLinkSlide(slidePosition)LinkImposta un Link sul Slide specificato utilizzando la posizione relativa della diapositiva.
setLinkUrl(url)LinkImposta un Link sulla stringa URL non vuota specificata.
setRotation(angle)LineImposta l'angolo di rotazione in senso orario dell'elemento attorno al suo centro in gradi.
setStart(left, top)LineImposta la posizione del punto di inizio della linea.
setStart(point)LineImposta la posizione del punto di inizio della linea.
setStartArrow(style)LineImposta il ArrowStyle della freccia all'inizio della riga.
setStartConnection(connectionSite)LineImposta la connessione all'inizio della riga.
setTitle(title)LineImposta il titolo del testo alternativo dell'elemento della pagina.
setTop(top)LineImposta la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
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 suo riquadro delimitante quando l'elemento non è ruotato.

Documentazione dettagliata

alignOnPage(alignmentPosition)

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

Parametri

NomeTipoDescrizione
alignmentPositionAlignmentPositionLa 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 scoprire 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()

Recupera il LineType della riga.

Invio

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

NomeTipoDescrizione
transformAffineTransformLa 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

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

NomeTipoDescrizione
ratioNumberIl 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 scoprire quali elementi della pagina non sono compatibili con questo metodo, consulta le limitazioni di ridimensionamento e posizionamento.

Parametri

NomeTipoDescrizione
ratioNumberIl 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:

  1. L'elemento Page principale dell'oggetto PageElement deve essere current page selection.
  2. 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

NomeTipoDescrizione
replaceBooleanSe 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

NomeTipoDescrizione
styleDashStyleLo 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

NomeTipoDescrizione
descriptionStringLa 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

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.

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

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

Parametri

NomeTipoDescrizione
styleArrowStyleLo 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

NomeTipoDescrizione
connectionSiteConnectionSiteIl 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 scoprire quali elementi della pagina non sono compatibili con questo metodo, consulta le limitazioni di ridimensionamento e posizionamento.

Parametri

NomeTipoDescrizione
heightNumberLa 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

NomeTipoDescrizione
leftNumberLa 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

NomeTipoDescrizione
lineCategoryLineCategoryLa 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

NomeTipoDescrizione
slideIndexIntegerL'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

NomeTipoDescrizione
slideSlideL'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

NomeTipoDescrizione
slidePositionSlidePositionIl 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

NomeTipoDescrizione
urlStringLa 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

NomeTipoDescrizione
angleNumberIl 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

NomeTipoDescrizione
leftNumberLa posizione orizzontale del punto di inizio della linea, misurata in punti dall'angolo in alto a sinistra della pagina.
topNumberLa 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

NomeTipoDescrizione
pointPointIl 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

NomeTipoDescrizione
styleArrowStyleIl 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

NomeTipoDescrizione
connectionSiteConnectionSiteIl 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

NomeTipoDescrizione
titleStringLa 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

NomeTipoDescrizione
topNumberLa 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

NomeTipoDescrizione
transformAffineTransformLa 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

NomeTipoDescrizione
pointsNumberIl 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 scoprire quali elementi della pagina non sono compatibili con questo metodo, consulta le limitazioni di ridimensionamento e posizionamento.

Parametri

NomeTipoDescrizione
widthNumberLa 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