Un PageElement
che rappresenta un'immagine.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
alignOnPage(alignmentPosition) | Image | Allinea l'elemento alla posizione di allineamento specificata sulla pagina. |
bringForward() | Image | Porta l'elemento in avanti nella pagina di un elemento. |
bringToFront() | Image | Porta l'elemento di pagina in primo piano nella pagina. |
duplicate() | PageElement | Duplica l'elemento della pagina. |
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. |
getBlob() | Blob | Restituisce i dati all'interno dell'immagine sotto forma di blob. |
getBorder() | Border | Restituisce il valore Border dell'immagine. |
getConnectionSites() | ConnectionSite[] | Restituisce l'elenco di ConnectionSite nell'elemento della pagina o un elenco vuoto se la pagina
non ha siti di connessione. |
getContentUrl() | String | Recupera un URL che rimanda all'immagine. |
getDescription() | String | Restituisce la descrizione del testo alternativo dell'elemento della pagina. |
getHeight() | Number | Restituisce l'altezza in punti dell'elemento, ovvero l'altezza del riquadro di delimitazione dell'elemento quando non ha rotazione. |
getInherentHeight() | Number | Restituisce l'altezza intrinseca dell'elemento in punti. |
getInherentWidth() | Number | Restituisce la larghezza intrinseca dell'elemento in punti. |
getLeft() | Number | Restituisce la posizione orizzontale dell'elemento in punti, misurata dall'angolo superiore sinistro della 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 della pagina, rappresentato come un enum PageElementType . |
getParentGroup() | Group | Restituisce il gruppo a cui appartiene questo elemento di pagina o null se l'elemento non fa parte di un
gruppo. |
getParentPage() | Page | Restituisce la pagina su cui si trova questo elemento di pagina. |
getParentPlaceholder() | PageElement | Restituisce l'elemento di pagina principale del segnaposto. |
getPlaceholderIndex() | Integer | Restituisce l'indice dell'immagine segnaposto. |
getPlaceholderType() | PlaceholderType | Restituisce il tipo di segnaposto dell'immagine o PlaceholderType.NONE se la forma non è
un segnaposto. |
getRotation() | Number | Restituisce l'angolo di rotazione orario dell'elemento intorno al suo centro in gradi, dove zero gradi significa nessuna rotazione. |
getSourceUrl() | String | Ottiene l'URL di origine dell'immagine, se disponibile. |
getTitle() | String | Restituisce il titolo del testo alternativo dell'elemento della pagina. |
getTop() | Number | Restituisce la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione. |
getTransform() | AffineTransform | Restituisce la trasformazione dell'elemento della pagina. |
getWidth() | Number | Restituisce la larghezza in punti dell'elemento, ovvero la larghezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione. |
preconcatenateTransform(transform) | Image | Preconcatena la trasformazione fornita alla trasformazione esistente dell'elemento della pagina. |
remove() | void | Rimuove l'elemento della pagina. |
removeLink() | void | Rimuove un Link . |
replace(blobSource) | Image | Sostituisce questa immagine con un'immagine descritta da un oggetto BlobSource . |
replace(blobSource, crop) | Image | Sostituisce questa immagine con un'immagine descritta da un oggetto Image , ritagliabile facoltativamente
l'immagine per adattarla. |
replace(imageUrl) | Image | Sostituisce questa immagine con un'altra immagine scaricata dall'URL fornito. |
replace(imageUrl, crop) | Image | Sostituisce questa immagine con un'altra immagine scaricata dall'URL fornito, ritagliandola facoltativamente l'immagine per adattarla. |
scaleHeight(ratio) | Image | Ridimensiona l'altezza dell'elemento in base al rapporto specificato. |
scaleWidth(ratio) | Image | Ridimensiona la larghezza dell'elemento in base al rapporto specificato. |
select() | void | Seleziona solo il PageElement nella presentazione attiva e rimuove gli eventuali
selezione. |
select(replace) | void | Consente di selezionare PageElement nella presentazione attiva. |
sendBackward() | Image | Invia l'elemento indietro sulla pagina di un elemento. |
sendToBack() | Image | Invia l'elemento di pagina in fondo alla pagina. |
setDescription(description) | Image | Imposta la descrizione del testo alternativo dell'elemento della pagina. |
setHeight(height) | Image | Consente di impostare l'altezza in punti dell'elemento, ovvero l'altezza del riquadro di delimitazione dell'elemento quando non ha rotazione. |
setLeft(left) | Image | Consente di impostare la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra dello quando l'elemento non ha rotazione. |
setLinkSlide(slideIndex) | Link | Imposta un Link per il Slide specificato utilizzando l'indice in base zero della slide. |
setLinkSlide(slide) | Link | Imposta un Link sul Slide specificato, il link viene impostato in base all'ID slide specificato. |
setLinkSlide(slidePosition) | Link | Imposta un Link per il Slide specificato utilizzando la posizione relativa della slide. |
setLinkUrl(url) | Link | Imposta un Link sulla stringa URL non vuota specificata. |
setRotation(angle) | Image | Consente di impostare l'angolo di rotazione orario dell'elemento intorno al centro in gradi. |
setTitle(title) | Image | Imposta il titolo del testo alternativo dell'elemento della pagina. |
setTop(top) | Image | Consente di impostare la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione. |
setTransform(transform) | Image | Imposta la trasformazione dell'elemento di pagina con la trasformazione fornita. |
setWidth(width) | Image | Consente di impostare la larghezza in punti dell'elemento, ovvero la larghezza del riquadro di delimitazione dell'elemento quando non ha rotazione. |
Documentazione dettagliata
alignOnPage(alignmentPosition)
Allinea l'elemento alla posizione di allineamento specificata sulla pagina.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
alignmentPosition | AlignmentPosition | La posizione in cui allineare questo elemento sulla pagina. |
Invio
Image
: questo elemento di pagina, per il concatenamento.
bringForward()
Porta l'elemento in avanti nella pagina di un elemento.
L'elemento di pagina non deve essere in un gruppo.
Invio
Image
: questo 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 nella pagina.
L'elemento di pagina non deve essere in un gruppo.
Invio
Image
: questo 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 della pagina.
L'elemento di pagina duplicato viene posizionato nella stessa pagina nella stessa posizione dell'originale.
Invio
PageElement
: il nuovo duplicato di 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
getAs(contentType)
Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. Questo aggiunge l'estensione appropriata al nome del file, ad esempio "miofile.pdf". Tuttavia, presuppone che la parte del nome file che segue l'ultimo punto (se presente) sia una un'estensione che deve essere sostituita. Di conseguenza, "ShoppingList.25.12.2014" diventa "ShoppingList.12.25.pdf".
Per visualizzare le quote giornaliere per le conversioni, consulta Quote per Google Servizi. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a restrizioni quote.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
contentType | String | Il tipo MIME in cui eseguire la conversione. Per la maggior parte dei blob, 'application/pdf' è
è l'unica opzione valida. Per le immagini in formato BMP, GIF, JPEG o PNG, vengono visualizzati anche i valori 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png'
valida. Per un documento di Documenti Google è valido anche 'text/markdown' . |
Invio
Blob
: i dati come blob.
getBlob()
Restituisce i dati all'interno dell'immagine sotto forma di blob.
Invio
Blob
: i dati dell'immagine sotto forma di blob.
getBorder()
Restituisce il valore Border
dell'immagine.
Invio
Border
: il bordo dell'immagine.
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 della pagina o un elenco vuoto se la pagina
non ha siti di connessione.
Invio
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
getContentUrl()
Recupera un URL che rimanda all'immagine.
Questo URL è codificato con l'account del richiedente, in modo che chiunque abbia l'URL accede all'immagine come richiedente originale. L'accesso all'immagine potrebbe andare perso se modifica delle impostazioni di condivisione della presentazione. L'URL restituito scade dopo un breve periodo di tempo.
Invio
String
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 è combinata con il titolo per visualizzare e leggere il testo alternativo.
Invio
String
: 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
getHeight()
Restituisce l'altezza in punti dell'elemento, ovvero l'altezza del riquadro di delimitazione dell'elemento quando non ha rotazione.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limiti di dimensioni e posizionamento.
Invio
Number
: l'altezza intrinseca dell'elemento di pagina in punti o null
se l'elemento della pagina ha
non hanno 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 alla sua dimensione intrinseca. Utilizza la dimensione intrinseca 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 o null
se l'elemento della pagina ha
non hanno 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 alla sua dimensione intrinseca. Utilizza la dimensione intrinseca 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 o null
se l'elemento della pagina ha
non hanno 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 superiore sinistro della quando l'elemento non ha rotazione.
Invio
Number
: la posizione orizzontale in punti di questo elemento, 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()); }
Invio
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 nello stesso spazio dei nomi.
Invio
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 della pagina, rappresentato come un enum PageElementType
.
Invio
PageElementType
: 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 o null
se l'elemento non fa parte di un
gruppo.
Invio
Group
: gruppo a cui appartiene questo elemento di pagina, ovvero 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 su cui si trova questo elemento di pagina.
Invio
Page
: la pagina su 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
getParentPlaceholder()
Restituisce l'elemento di pagina principale del segnaposto. Restituisce null
se l'immagine non è un
segnaposto o non ha un padre.
Invio
PageElement
: l'elemento della pagina principale di questo segnaposto dell'immagine o null
se l'immagine non è
un segnaposto o non ha un padre.
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 dell'immagine segnaposto. Se due o più immagini segnaposto sulla stessa pagina
sono dello stesso tipo, ciascuno ha un valore di indice univoco. Restituisce null
se l'immagine non è
un segnaposto.
Invio
Integer
: indice segnaposto di questa immagine o null
se l'immagine 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 dell'immagine o PlaceholderType.NONE
se la forma non è
un segnaposto.
Invio
PlaceholderType
: il tipo di segnaposto per questa immagine.
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 orario dell'elemento intorno 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
getSourceUrl()
Ottiene l'URL di origine dell'immagine, se disponibile.
Quando un'immagine viene inserita tramite URL, restituisce l'URL fornito durante l'inserimento dell'immagine.
Invio
String
: l'URL dell'immagine o null
se l'immagine non ha un URL di origine.
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 è 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 ha rotazione.
Invio
Number
: la posizione verticale di questo elemento in punti, dall'angolo superiore sinistro 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. A calcolare la trasformazione assoluta, preconcatenare 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 sua trasformazione assoluta è uguale al valore di questo campo.
Invio
AffineTransform
: la trasformazione 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
getWidth()
Restituisce la larghezza in punti dell'elemento, 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 della pagina non sono compatibili con questo metodo, consulta le limiti di dimensioni e posizionamento.
Invio
Number
: la larghezza intrinseca dell'elemento di pagina in punti o null
se l'elemento della pagina ha
non hanno 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 da preconcatenare alla trasformazione di questo elemento della pagina. |
Invio
Image
: questo 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 l'elemento Group
contiene solo uno o nessun elemento di pagina,
viene rimosso anche dal gruppo stesso.
Se un segnaposto PageElement
viene rimosso da uno schema o da un layout, qualsiasi ereditarietà vuota
vengono rimossi anche i 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
removeLink()
Rimuove un Link
.
shape.removeLink();
replace(blobSource)
Sostituisce questa immagine con un'immagine descritta da un oggetto BlobSource
.
L'inserimento dell'immagine ne consente il recupero dal
BlobSource
una volta sola e ne viene archiviata una copia per visualizzarla all'interno della presentazione.
Le immagini devono avere dimensioni inferiori a 50 MB, non più di 25 megapixel e devono essere in formato
PNG, JPEG o GIF.
Per mantenere le proporzioni, l'immagine viene ridimensionata e centrata nel rispetto alla dimensione dell'immagine esistente.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); image.replace(driveImage);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blobSource | BlobSource | I dati dell'immagine. |
Invio
Image
: Image
dopo la sostituzione.
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
replace(blobSource, crop)
Sostituisce questa immagine con un'immagine descritta da un oggetto Image
, ritagliabile facoltativamente
l'immagine per adattarla.
Inserendo l'immagine, questa viene recuperata dal
BlobSource
una volta sola e ne viene archiviata una copia per visualizzarla 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 image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); // Replace and crop the drive image. image.replace(driveImage, true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blobSource | BlobSource | I dati dell'immagine. |
crop | Boolean | Se true , l'immagine viene ritagliata per adattarla alle dimensioni dell'immagine esistente. In caso contrario,
l'immagine sia ridimensionata e centrata. |
Invio
Image
: Image
dopo la sostituzione.
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
replace(imageUrl)
Sostituisce questa immagine con un'altra immagine scaricata dall'URL fornito.
Inserendo l'immagine, questa viene recuperata dall'URL una volta sola e ne viene archiviata una copia per la visualizzazione all'interno del una 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 getSourceUrl()
.
Per mantenere le proporzioni, l'immagine viene ridimensionata e centrata nel rispetto alla dimensione dell'immagine esistente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
imageUrl | String | L'URL da cui scaricare l'immagine. |
Invio
Image
: Image
dopo la sostituzione.
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
replace(imageUrl, crop)
Sostituisce questa immagine con un'altra immagine scaricata dall'URL fornito, ritagliandola facoltativamente l'immagine per adattarla.
Inserendo l'immagine, questa viene recuperata dall'URL una volta sola e ne viene archiviata una copia per la visualizzazione all'interno del una 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 essere superiore a 2 kB.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
imageUrl | String | L'URL da cui scaricare l'immagine. |
crop | Boolean | Se true , l'immagine viene ritagliata per adattarla alle dimensioni dell'immagine esistente. In caso contrario,
l'immagine sia ridimensionata e centrata. |
Invio
Image
: Image
dopo la sostituzione.
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)
Ridimensiona l'altezza dell'elemento in base al rapporto specificato. L'altezza dell'elemento è l'altezza del suo quando l'elemento non ha rotazione.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limiti di dimensioni e posizionamento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
ratio | Number | Il rapporto in base al quale scalare l'altezza di questo elemento della pagina. |
Invio
Image
: questo 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)
Ridimensiona la larghezza dell'elemento in base al rapporto specificato. La larghezza dell'elemento è la larghezza del suo quando l'elemento non ha rotazione.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limiti di dimensioni e posizionamento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
ratio | Number | Il rapporto in base al quale ridimensionare la larghezza di questo elemento della pagina. |
Invio
Image
: questo 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 il PageElement
nella presentazione attiva e rimuove gli eventuali
selezione. Equivale a chiamare select(replace)
con true
.
Uno script può accedere solo alla selezione dell'utente che lo esegue e solo se lo script è legato alla presentazione.
Questa operazione imposta il principale Page
di PageElement
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)
Consente di selezionare PageElement
nella presentazione attiva.
Uno script può accedere solo alla selezione dell'utente che lo esegue e solo se lo script è legato alla presentazione.
Passa true
a questo metodo per selezionare solo PageElement
e rimuovere eventuali
selezione precedente. Questa operazione imposta anche l'elemento principale Page
di PageElement
come
current page selection
.
Trasmetti false
per selezionare più oggetti PageElement
. PageElement
gli oggetti devono trovarsi nello stesso Page
.
Durante la selezione di un elemento di pagina utilizzando un false
, devono essere soddisfatte le seguenti condizioni
:
- Il
Page
principale dell'oggettoPageElement
deve esserecurrent page selection
. - Non devono essere selezionati più oggetti
Page
.
Per questo motivo l'approccio da preferire è selezionare l'elemento Page
principale.
usando Page.selectAsCurrentPage()
, quindi seleziona gli elementi della pagina in quella 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 indietro sulla pagina di un elemento.
L'elemento di pagina non deve essere in un gruppo.
Invio
Image
: questo 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 di pagina in fondo alla pagina.
L'elemento di pagina non deve essere in un gruppo.
Invio
Image
: 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
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". 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 la descrizione del testo alternativo. |
Invio
Image
: 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)
Consente di impostare l'altezza in punti dell'elemento, ovvero l'altezza del riquadro di delimitazione dell'elemento quando non ha rotazione.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limiti di dimensioni e posizionamento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
height | Number | La nuova altezza da impostare per questo elemento di pagina, in punti. |
Invio
Image
: 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)
Consente di impostare la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra dello quando l'elemento non ha rotazione.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
left | Number | La nuova posizione orizzontale da impostare, in punti. |
Invio
Image
: 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
per il 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 della slide. |
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. var slide = presentation.getSlides()[0]; shape.setLinkSlide(slide);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
slide | Slide | 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
per il 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 | L'elemento 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. shape.setLinkUrl("https://slides.google.com");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
url | String | La stringa dell'URL. |
Invio
Link
: il valore Link
impostato
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
Consente di impostare l'angolo di rotazione orario dell'elemento intorno al 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 limiti di dimensioni e posizionamento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
angle | Number | Il nuovo angolo di rotazione in senso orario da impostare, espresso in gradi. |
Invio
Image
: questo 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 della 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. |
Invio
Image
: 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)
Consente di impostare 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. |
Invio
Image
: questo 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 di pagina con la trasformazione fornita.
L'aggiornamento della trasformazione di un gruppo cambia la trasformazione assoluta degli elementi della pagina in gruppo, il che può modificarne l'aspetto visivo.
L'aggiornamento della trasformazione di un elemento di pagina che si trova in un gruppo cambia solo la trasformazione l'elemento della pagina. non influenza le trasformazioni del gruppo o di altri elementi della pagina in gruppo.
Per maggiori dettagli 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 della pagina. |
Invio
Image
: 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)
Consente di impostare la larghezza in punti dell'elemento, ovvero la larghezza del riquadro di delimitazione dell'elemento quando non ha rotazione.
Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta le limiti di dimensioni e posizionamento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
width | Number | La nuova larghezza da impostare per questo elemento di pagina, in punti. |
Invio
Image
: questo 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