Un PageElement
che rappresenta una forma generica che non ha una classificazione più specifica. Include caselle di testo, rettangoli e altre forme predefinite.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
alignOnPage(alignmentPosition) | Shape | Allinea l'elemento alla posizione di allineamento specificata nella pagina. |
bringForward() | Shape | Porta in avanti l'elemento di pagina nella pagina di un elemento. |
bringToFront() | Shape | Porta l'elemento di pagina in primo piano. |
duplicate() | PageElement | Duplica l'elemento di pagina. |
getAutofit() | Autofit | Restituisce il Autofit del testo all'interno di questa forma. |
getBorder() | Border | Restituisce il Border della forma. |
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. |
getContentAlignment() | ContentAlignment | Restituisce il ContentAlignment del testo nella forma. |
getDescription() | String | Restituisce la descrizione del testo alternativo dell'elemento di pagina. |
getFill() | Fill | Restituisce il Fill della forma. |
getHeight() | Number | Restituisce l'altezza in punti dell'elemento, ovvero l'altezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione. |
getInherentHeight() | Number | Restituisce l'altezza intrinseca in punti dell'elemento. |
getInherentWidth() | Number | Restituisce la larghezza intrinseca in punti dell'elemento. |
getLeft() | Number | Restituisce la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione. |
getLink() | Link | Restituisce Link o null in assenza di link. |
getObjectId() | String | Restituisce l'ID univoco dell'oggetto. |
getPageElementType() | PageElementType | Restituisce il tipo di elemento di pagina, rappresentato da un'enumerazione PageElementType . |
getParentGroup() | Group | Restituisce il gruppo a cui appartiene questo elemento di pagina oppure null se l'elemento non si trova in un gruppo. |
getParentPage() | Page | Restituisce la pagina in cui si trova questo elemento di pagina. |
getParentPlaceholder() | PageElement | Restituisce l'elemento della pagina principale del segnaposto. |
getPlaceholderIndex() | Integer | Restituisce l'indice segnaposto della forma. |
getPlaceholderType() | PlaceholderType | Restituisce il tipo di segnaposto della forma o PlaceholderType.NONE se la forma non è un segnaposto. |
getRotation() | Number | Restituisce l'angolo di rotazione in senso orario dell'elemento in gradi intorno al suo centro, dove zero gradi indica che non c'è rotazione. |
getShapeType() | ShapeType | Restituisce il tipo di forma. |
getText() | TextRange | Restituisce il contenuto testuale della forma. |
getTitle() | String | Restituisce il titolo del testo alternativo dell'elemento di pagina. |
getTop() | Number | Restituisce la posizione verticale dell'elemento in punti, misurata dall'angolo superiore sinistro della pagina quando l'elemento non ha rotazione. |
getTransform() | AffineTransform | Restituisce la trasformazione dell'elemento di pagina. |
getWidth() | Number | Restituisce la larghezza in punti dell'elemento, ovvero la larghezza del riquadro di delimitazione dell'elemento quando quest'ultimo non ha rotazione. |
preconcatenateTransform(transform) | Shape | Preconcatena la trasformazione fornita alla trasformazione esistente dell'elemento della pagina. |
remove() | void | Rimuove l'elemento della pagina. |
removeLink() | void | Rimuove un Link . |
replaceWithImage(blobSource) | Image | Sostituisce questa forma con un'immagine fornita da un BlobSource . |
replaceWithImage(blobSource, crop) | Image | Sostituisce questa forma con un'immagine fornita da un BlobSource . |
replaceWithImage(imageUrl) | Image | Sostituisce questa forma con un'immagine. |
replaceWithImage(imageUrl, crop) | Image | Sostituisce questa forma con un'immagine. |
replaceWithSheetsChart(sourceChart) | SheetsChart | Sostituisce questa forma con un grafico di Fogli Google. |
replaceWithSheetsChartAsImage(sourceChart) | Image | Sostituisce questa forma con l'immagine di un grafico di Fogli Google. |
scaleHeight(ratio) | Shape | Scala l'altezza dell'elemento in base al rapporto specificato. |
scaleWidth(ratio) | Shape | Scala la larghezza dell'elemento in base al rapporto specificato. |
select() | void | Seleziona solo PageElement nella presentazione attiva e rimuove eventuali selezioni precedenti. |
select(replace) | void | Seleziona PageElement nella presentazione attiva. |
sendBackward() | Shape | Invia l'elemento di pagina indietro di un elemento nella pagina. |
sendToBack() | Shape | Invia l'elemento della pagina in fondo alla pagina. |
setContentAlignment(contentAlignment) | Shape | Imposta il ContentAlignment del testo nella forma. |
setDescription(description) | Shape | Imposta la descrizione del testo alternativo dell'elemento di pagina. |
setHeight(height) | Shape | Imposta l'altezza dell'elemento in punti, ovvero l'altezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione. |
setLeft(left) | Shape | Imposta la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione. |
setLinkSlide(slideIndex) | Link | Imposta un Link sul valore Slide specificato utilizzando l'indice in base zero della slide. |
setLinkSlide(slide) | Link | Imposta un Link sul valore Slide specificato. Il collegamento viene impostato dall'ID slide specificato. |
setLinkSlide(slidePosition) | Link | Imposta un Link sul valore Slide specificato utilizzando la posizione relativa della slide. |
setLinkUrl(url) | Link | Imposta un valore Link sulla stringa URL non vuota specificata. |
setRotation(angle) | Shape | Imposta l'angolo di rotazione in senso orario dell'elemento intorno al suo centro in gradi. |
setTitle(title) | Shape | Imposta il titolo del testo alternativo dell'elemento di pagina. |
setTop(top) | Shape | Imposta la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione. |
setTransform(transform) | Shape | Imposta la trasformazione dell'elemento della pagina con la trasformazione fornita. |
setWidth(width) | Shape | Imposta 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
Nome | Tipo | Descrizione |
---|---|---|
alignmentPosition | AlignmentPosition | La posizione a cui allineare questo elemento di pagina sulla pagina. |
Ritorni
Shape
: 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
Shape
: 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
Shape
: 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
getAutofit()
Restituisce il Autofit
del testo all'interno di questa forma. Questo è null
se la forma
non consente testo.
Ritorni
Autofit
: l'adattamento automatico del testo all'interno di questa forma.
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
getBorder()
Restituisce il Border
della forma.
Ritorni
Border
: l'impostazione del bordo di questa forma.
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
getContentAlignment()
Restituisce il ContentAlignment
del testo nella forma.
Ritorni
ContentAlignment
: l'allineamento del testo all'interno di questa forma.
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
getFill()
Restituisce il Fill
della forma.
Ritorni
Fill
: l'impostazione di riempimento di questa forma.
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
getLink()
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
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
getParentPlaceholder()
Restituisce l'elemento della pagina principale del segnaposto. Restituisce null
se la forma non è un segnaposto o non ha un elemento padre.
Ritorni
PageElement
: l'elemento della pagina principale di questo segnaposto di forma oppure null
se la forma non è
un segnaposto o non ha un elemento principale.
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
getPlaceholderIndex()
Restituisce l'indice segnaposto della forma. Se nella stessa pagina sono presenti due o più istanze degli stessi tipi di segnaposto, avranno ciascuna un proprio valore di indice univoco. Restituisce null
se la forma non è un segnaposto.
Ritorni
Integer
: l'indice dei segnaposto di questa forma o null
se la forma non è un segnaposto.
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
getPlaceholderType()
Restituisce il tipo di segnaposto della forma o PlaceholderType.NONE
se la forma non è un segnaposto.
Ritorni
PlaceholderType
: il tipo di segnaposto per questa forma.
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
getShapeType()
getText()
Restituisce il contenuto testuale della forma.
Il testo all'interno di una forma termina sempre con un carattere di nuova riga.
Ritorni
TextRange
: contenuti testuali di questa forma.
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
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
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
Nome | Tipo | Descrizione |
---|---|---|
transform | AffineTransform | La trasformazione per preconcatenare la trasformazione di questo elemento di pagina. |
Ritorni
Shape
: 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
removeLink()
Rimuove un Link
.
shape.removeLink();
replaceWithImage(blobSource)
Sostituisce questa forma con un'immagine fornita da un BlobSource
.
L'immagine viene recuperata dall'elemento BlobSource
fornito una volta al momento dell'inserimento e una copia viene archiviata per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
Per mantenere le proporzioni dell'immagine, questa viene scalata e centrata rispetto alle dimensioni della forma esistente.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); shape.replaceWithImage(driveImage);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blobSource | BlobSource | I dati dell'immagine. |
Ritorni
Image
: il valore Image
che ha sostituito la forma.
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
replaceWithImage(blobSource, crop)
Sostituisce questa forma con un'immagine fornita da un BlobSource
.
Se inserisci l'immagine, questa viene recuperata da BlobSource
una volta e una copia viene archiviata per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); // Replace and crop the replaced image. shape.replaceWithImage(driveImage, true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blobSource | BlobSource | I dati dell'immagine. |
crop | Boolean | Se true , ritaglia l'immagine per adattarla alle dimensioni della forma esistente. In caso contrario, l'immagine viene ridimensionata e centrata. |
Ritorni
Image
: il valore Image
che ha sostituito la forma.
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
replaceWithImage(imageUrl)
Sostituisce questa forma con un'immagine.
Se inserisci l'immagine, questa viene recuperata dall'URL una volta e una copia viene archiviata per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
L'URL fornito deve essere accessibile pubblicamente e non deve superare i 2 kB. L'URL stesso viene salvato
con l'immagine ed esposto tramite Image.getSourceUrl()
.
Per mantenere le proporzioni dell'immagine, questa viene scalata e centrata rispetto alle dimensioni della forma esistente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
imageUrl | String | L'URL dell'immagine da cui scaricare l'immagine. |
Ritorni
Image
: il valore Image
che ha sostituito la forma.
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
replaceWithImage(imageUrl, crop)
Sostituisce questa forma con un'immagine.
Se inserisci l'immagine, questa viene recuperata dall'URL una volta e una copia viene archiviata per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
L'URL fornito non deve superare i 2 kB. L'URL stesso viene salvato con l'immagine ed
esposto tramite Image.getSourceUrl()
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
imageUrl | String | L'URL dell'immagine da cui scaricare l'immagine. |
crop | Boolean | Se true , ritaglia l'immagine per adattarla alle dimensioni della forma esistente. In caso contrario, l'immagine viene ridimensionata e centrata. |
Ritorni
Image
: il valore Image
che ha sostituito la forma.
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
replaceWithSheetsChart(sourceChart)
Sostituisce questa forma con un grafico di Fogli Google.
Il grafico è collegato al grafico di origine di Fogli Google, che ne consente l'aggiornamento. Altri collaboratori possono visualizzare il link al foglio di lavoro di origine.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Replace the shape with the Sheets chart. var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.replaceWithSheetsChart(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sourceChart | EmbeddedChart | Il grafico in un foglio di lavoro che sostituisce la forma. |
Ritorni
SheetsChart
: il grafico che ha sostituito la forma.
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
replaceWithSheetsChartAsImage(sourceChart)
Sostituisce questa forma con l'immagine di un grafico di Fogli Google.
Per mantenere le proporzioni del grafico di Fogli Google, l'immagine viene scalata e centrata rispetto alle dimensioni della forma esistente.
L'immagine del grafico non è collegata al grafico di Fogli Google di origine.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Replace the shape with the Sheets chart as an image. var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.replaceWithSheetsChartAsImage(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sourceChart | EmbeddedChart | Il grafico in un foglio di lavoro che sostituisce la forma. |
Ritorni
Image
: l'immagine del grafico che ha sostituito la forma.
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
Nome | Tipo | Descrizione |
---|---|---|
ratio | Number | Il rapporto per cui ridimensionare l'altezza di questo elemento di pagina. |
Ritorni
Shape
: 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
Nome | Tipo | Descrizione |
---|---|---|
ratio | Number | Il rapporto per cui ridimensionare la larghezza di questo elemento di pagina. |
Ritorni
Shape
: 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
:
- L'elemento
Page
principale dell'oggettoPageElement
deve esserecurrent page selection
. - 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
Nome | Tipo | Descrizione |
---|---|---|
replace | Boolean | Se 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
Shape
: 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
Shape
: 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
setContentAlignment(contentAlignment)
Imposta il ContentAlignment
del testo nella forma.
Questo metodo disattiva automaticamente le proprietà di adattamento automatico del testo nelle forme aggiornate.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
contentAlignment | ContentAlignment | L'allineamento da impostare. |
Ritorni
Shape
: questa forma, 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
Nome | Tipo | Descrizione |
---|---|---|
description | String | La stringa su cui impostare il testo alternativo della descrizione. |
Ritorni
Shape
: 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
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
Nome | Tipo | Descrizione |
---|---|---|
height | Number | La nuova altezza da impostare di questo elemento di pagina, espressa in punti. |
Ritorni
Shape
: 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
Nome | Tipo | Descrizione |
---|---|---|
left | Number | La nuova posizione orizzontale da impostare, in punti. |
Ritorni
Shape
: 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
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
Nome | Tipo | Descrizione |
---|---|---|
slideIndex | Integer | L'indice in base zero alla slide. |
Ritorni
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
Nome | Tipo | Descrizione |
---|---|---|
slide | Slide | Slide da collegare. |
Ritorni
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
Nome | Tipo | Descrizione |
---|---|---|
slidePosition | SlidePosition | Il relativo SlidePosition . |
Ritorni
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
Nome | Tipo | Descrizione |
---|---|---|
url | String | La stringa dell'URL. |
Ritorni
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
Nome | Tipo | Descrizione |
---|---|---|
angle | Number | Il nuovo angolo di rotazione in senso orario da impostare, espresso in gradi. |
Ritorni
Shape
: 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
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
Nome | Tipo | Descrizione |
---|---|---|
title | String | La stringa su cui impostare il titolo del testo alternativo. |
Ritorni
Shape
: 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
Nome | Tipo | Descrizione |
---|---|---|
top | Number | La nuova posizione verticale da impostare, in punti. |
Ritorni
Shape
: 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
Nome | Tipo | Descrizione |
---|---|---|
transform | AffineTransform | La trasformazione impostata per questo elemento di pagina. |
Ritorni
Shape
: 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
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
Nome | Tipo | Descrizione |
---|---|---|
width | Number | La nuova larghezza da impostare di questo elemento di pagina, espressa in punti. |
Ritorni
Shape
: 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