Questa pagina è stata tradotta dall'API Cloud Translation.

Class Shape

Un PageElement che rappresenta una forma generica che non ha una classificazione più specifica. Sono incluse 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 l'elemento della pagina in primo piano nella pagina di un elemento.
`bringToFront()`	`Shape`	Porta l'elemento della pagina in primo piano.
`duplicate()`	`PageElement`	Duplica l'elemento della 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 dei `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 della pagina.
`getFill()`	`Fill`	Restituisce il `Fill` della forma.
`getHeight()`	`Number`	Restituisce l'altezza dell'elemento in punti, ovvero l'altezza del suo riquadro delimitante quando l'elemento non è ruotato.
`getInherentHeight()`	`Number`	Restituisce l'altezza intrinseca dell'elemento in punti.
`getInherentWidth()`	`Number`	Restituisce la larghezza intrinseca dell'elemento in punti.
`getLeft()`	`Number`	Restituisce la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
`getLink()`	`Link`	Restituisce `Link` o `null` se non è presente alcun collegamento.
`getObjectId()`	`String`	Restituisce l'ID univoco di questo oggetto.
`getPageElementType()`	`PageElementType`	Restituisce il tipo di elemento della pagina, rappresentato come enum `PageElementType`.
`getParentGroup()`	`Group`	Restituisce il gruppo a cui appartiene questo elemento di pagina o `null` se l'elemento non fa parte di un gruppo.
`getParentPage()`	`Page`	Restituisce la pagina in cui si trova questo elemento di pagina.
`getParentPlaceholder()`	`PageElement`	Restituisce l'elemento della pagina principale del segnaposto.
`getPlaceholderIndex()`	`Integer`	Restituisce l'indice del 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 attorno al suo centro in gradi, dove zero gradi significa nessuna rotazione.
`getShapeType()`	`ShapeType`	Restituisce il tipo di forma.
`getText()`	`TextRange`	Restituisce il contenuto del testo della forma.
`getTitle()`	`String`	Restituisce il titolo del testo alternativo dell'elemento della pagina.
`getTop()`	`Number`	Restituisce la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
`getTransform()`	`AffineTransform`	Restituisce la trasformazione dell'elemento della pagina.
`getWidth()`	`Number`	Restituisce la larghezza dell'elemento in punti, ovvero la larghezza del suo riquadro delimitante quando l'elemento non è ruotato.
`preconcatenateTransform(transform)`	`Shape`	Preconcatenate 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 un'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`	Consente di selezionare solo il `PageElement` nella presentazione attiva e di rimuovere qualsiasi selezione precedente.
`select(replace)`	`void`	Consente di selezionare `PageElement` nella presentazione attiva.
`sendBackward()`	`Shape`	Sposta l'elemento della pagina indietro di un elemento.
`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 della pagina.
`setHeight(height)`	`Shape`	Imposta l'altezza dell'elemento in punti, ovvero l'altezza del suo riquadro delimitante quando l'elemento non è ruotato.
`setLeft(left)`	`Shape`	Imposta la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
`setLinkSlide(slideIndex)`	`Link`	Imposta un `Link` per il `Slide` specificato utilizzando l'indice a partire da zero della diapositiva.
`setLinkSlide(slide)`	`Link`	Imposta un `Link` sul `Slide` specificato. Il link viene impostato in base all'ID slide specificato.
`setLinkSlide(slidePosition)`	`Link`	Imposta un `Link` sul `Slide` specificato utilizzando la posizione relativa della diapositiva.
`setLinkUrl(url)`	`Link`	Imposta un `Link` sulla stringa URL non vuota specificata.
`setRotation(angle)`	`Shape`	Imposta l'angolo di rotazione in senso orario dell'elemento attorno al suo centro in gradi.
`setTitle(title)`	`Shape`	Imposta il titolo del testo alternativo dell'elemento della 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 è ruotato.
`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 suo riquadro delimitante quando l'elemento non è ruotato.

Documentazione dettagliata

`alignOnPage(alignmentPosition)`

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

Parametri

Nome	Tipo	Descrizione
`alignmentPosition`	`AlignmentPosition`	La posizione in base alla quale allineare questo elemento della pagina.

Invio

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

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

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

`getAutofit()`

Restituisce il Autofit del testo all'interno di questa forma. Si tratta di null se la forma non consente il testo.

Invio

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.

Invio

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

`getContentAlignment()`

Restituisce il ContentAlignment del testo nella forma.

Invio

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

`getFill()`

Restituisce il Fill della forma.

Invio

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 dell'elemento in punti, ovvero l'altezza del suo riquadro delimitante quando l'elemento non è ruotato.

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

Invio

Number: l'altezza intrinseca dell'elemento di pagina in punti oppure null se l'elemento di pagina non ha un'altezza.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentHeight()`

Restituisce l'altezza intrinseca dell'elemento in punti.

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

Invio

Number: l'altezza intrinseca dell'elemento di pagina in punti oppure null se l'elemento di pagina non ha un'altezza.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentWidth()`

Restituisce la larghezza intrinseca dell'elemento in punti.

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

`getLink()`

Restituisce Link o null se non è presente alcun collegamento.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

Invio

Link: Link o null se non è presente alcun link.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getObjectId()`

Restituisce l'ID univoco di questo oggetto. Gli ID oggetto utilizzati dalle pagine e dagli elementi della pagina condividono lo stesso spazio dei nomi.

Invio

String: l'ID univoco di questo oggetto.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPageElementType()`

Restituisce il tipo di elemento della pagina, rappresentato come enum PageElementType.

Invio

PageElementType: il tipo di elemento pagina.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentGroup()`

Restituisce il gruppo a cui appartiene questo elemento di pagina o null se l'elemento non fa parte di un gruppo.

Invio

Group: il gruppo a cui appartiene questo elemento della pagina o null.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPage()`

Restituisce la pagina in cui si trova questo elemento di pagina.

Invio

Page: la pagina in cui si trova l'elemento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPlaceholder()`

Restituisce l'elemento della pagina principale del segnaposto. Restituisce null se la forma non è un segnaposto o non ha un elemento principale.

Invio

PageElement: l'elemento della pagina principale di questo segnaposto della forma oppure null se questa 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 del segnaposto della forma. Se nella stessa pagina sono presenti due o più istanze dello stesso tipo di segnaposto, ognuna ha un proprio valore di indice univoco. Restituisce null se la forma non è un segnaposto.

Invio

Integer: l'indice del 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.

Invio

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

`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

`getShapeType()`

Restituisce il tipo di forma.

Invio

ShapeType: il tipo di questa forma.

`getText()`

Restituisce il contenuto del testo della forma.

Il testo all'interno di una forma termina sempre con un carattere di nuova riga.

Invio

TextRange: il contenuto di testo 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 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

`getWidth()`

Restituisce la larghezza dell'elemento in punti, ovvero la larghezza del suo riquadro delimitante quando l'elemento non è ruotato.

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

`preconcatenateTransform(transform)`

Preconcatenate la trasformazione fornita alla trasformazione esistente dell'elemento della pagina.

newTransform = argument * existingTransform;

Ad esempio, per spostare gli elementi di una pagina di 36 punti a sinistra:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

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

Parametri

Nome	Tipo	Descrizione
`transform`	`AffineTransform`	La trasformazione da preconcatenare alla trasformazione dell'elemento di pagina.

Invio

Shape: questo elemento della pagina, per l'accodamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`remove()`

Rimuove l'elemento della pagina.

Se dopo un'operazione di rimozione un Group contiene solo uno o nessun elemento di pagina, viene rimosso anche il gruppo stesso.

Se un segnaposto PageElement viene rimosso in un modello o in un layout, vengono rimossi anche gli eventuali segnaposto ereditati vuoti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`removeLink()`

Rimuove un Link.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

`replaceWithImage(blobSource)`

Sostituisce questa forma con un'immagine fornita da un BlobSource.

L'immagine viene recuperata dal 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 ridimensionata e centrata in base alle dimensioni della forma esistente.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
shape.replaceWithImage(driveImage);

Parametri

Nome	Tipo	Descrizione
`blobSource`	`BlobSource`	I dati immagine.

Invio

Image: il 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.

L'inserimento dell'immagine la recupera una volta da BlobSource e ne viene archiviata una copia 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.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

Parametri

Nome	Tipo	Descrizione
`blobSource`	`BlobSource`	I dati immagine.
`crop`	`Boolean`	Se `true`, l'immagine viene ritagliata in base alle dimensioni della forma esistente. In caso contrario, l'immagine viene ridimensionata e centrata.

Invio

Image: il 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.

L'inserimento dell'immagine la recupera dall'URL una volta e ne viene memorizzata una copia 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 pubblicamente accessibile 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 ridimensionata e centrata in base alle dimensioni della forma esistente.

Parametri

Nome	Tipo	Descrizione
`imageUrl`	`String`	L'URL dell'immagine da cui scaricarla.

Invio

Image: il 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.

L'URL fornito non deve superare i 2 kB. L'URL stesso viene salvato con l'immagine e visualizzato tramite Image.getSourceUrl().

Parametri

Nome	Tipo	Descrizione
`imageUrl`	`String`	L'URL dell'immagine da cui scaricarla.
`crop`	`Boolean`	Se `true`, l'immagine viene ritagliata in base alle dimensioni della forma esistente. In caso contrario, l'immagine viene ridimensionata e centrata.

Invio

Image: il 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, il che consente di aggiornarlo. Gli altri collaboratori possono vedere il link al foglio di lavoro di origine.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
const 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.

Invio

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 un'immagine di un grafico di Fogli Google.

Per mantenere le proporzioni del grafico di Fogli Google, l'immagine del grafico viene ridimensionata e centrata rispetto alle dimensioni della forma esistente.

L'immagine del grafico non è collegata al grafico di Fogli Google di origine.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
const 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.

Invio

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 corrisponde all'altezza del suo bounding box quando l'elemento non è ruotato.

Parametri

Nome	Tipo	Descrizione
`ratio`	`Number`	Il rapporto per scalare l'altezza di questo elemento della pagina.

Invio

Shape: 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.

Parametri

Nome	Tipo	Descrizione
`ratio`	`Number`	Il rapporto per scalare la larghezza di questo elemento della pagina.

Invio

Shape: questo elemento della pagina, per l'accodamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select()`

Consente di selezionare solo il PageElement nella presentazione attiva e di rimuovere qualsiasi selezione precedente. È come chiamare select(replace) con true.

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

In questo modo, il Page principale del PageElement viene impostato come current page selection.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select(replace)`

Consente di selezionare PageElement nella presentazione attiva.

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

Passa true a questo metodo per selezionare solo PageElement e rimuovere eventuali selezione precedenti. Viene impostato anche il Page principale del PageElement come current page selection.

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

Quando selezioni un elemento della pagina utilizzando un parametro false , devono essere soddisfatte le seguenti condizioni:

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

Per assicurarti che sia così, l'approccio preferito è selezionare prima l'elemento principale Page utilizzando Page.selectAsCurrentPage() e poi gli elementi della pagina in quella pagina.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parametri

Nome	Tipo	Descrizione
`replace`	`Boolean`	Se `true`, la selezione sostituisce qualsiasi selezione precedente; altrimenti la selezione viene aggiunta a qualsiasi selezione precedente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendBackward()`

Spostalo indietro di un elemento nella pagina.

L'elemento pagina non deve essere in un gruppo.

Invio

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

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

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

Invio

Shape: questa forma, per l'accodamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setDescription(description)`

Imposta la descrizione del testo alternativo dell'elemento della pagina.

Il metodo non è supportato per gli elementi Group.

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

Parametri

Nome	Tipo	Descrizione
`description`	`String`	La stringa a cui impostare la descrizione del testo alternativo.

Invio

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

`setHeight(height)`

Imposta l'altezza dell'elemento in punti, ovvero l'altezza del suo riquadro delimitante quando l'elemento non è ruotato.

Parametri

Nome	Tipo	Descrizione
`height`	`Number`	La nuova altezza dell'elemento della pagina da impostare, in punti.

Invio

Shape: questo elemento della pagina, per l'accodamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLeft(left)`

Imposta la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.

Parametri

Nome	Tipo	Descrizione
`left`	`Number`	La nuova posizione orizzontale da impostare, in punti.

Invio

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

`setLinkSlide(slideIndex)`

Imposta un Link per il Slide specificato utilizzando l'indice a partire da zero della diapositiva.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

Parametri

Nome	Tipo	Descrizione
`slideIndex`	`Integer`	L'indice della diapositiva basato su zero.

Invio

Link: il valore Link impostato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slide)`

Imposta un Link sul Slide specificato. Il link viene impostato in base all'ID slide specificato.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

Parametri

Nome	Tipo	Descrizione
`slide`	`Slide`	L'`Slide` da collegare.

Invio

Link: il valore Link impostato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slidePosition)`

Imposta un Link sul Slide specificato utilizzando la posizione relativa della diapositiva.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Parametri

Nome	Tipo	Descrizione
`slidePosition`	`SlidePosition`	Il `SlidePosition` relativo.

Invio

Link: il valore Link impostato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkUrl(url)`

Imposta un Link sulla stringa URL non vuota specificata.

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

Parametri

Nome	Tipo	Descrizione
`url`	`String`	La stringa dell'URL.

Invio

Link: il valore Link impostato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setRotation(angle)`

Imposta l'angolo di rotazione in senso orario dell'elemento attorno al suo centro in gradi.

Parametri

Nome	Tipo	Descrizione
`angle`	`Number`	Il nuovo angolo di rotazione in senso orario da impostare, in gradi.

Invio

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

`setTitle(title)`

Imposta il titolo del testo alternativo dell'elemento della pagina.

Il metodo non è supportato per gli elementi Group.

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

Parametri

Nome	Tipo	Descrizione
`title`	`String`	La stringa a cui impostare il titolo del testo alternativo.

Invio

Shape: questo elemento della pagina.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTop(top)`

Imposta la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.

Parametri

Nome	Tipo	Descrizione
`top`	`Number`	La nuova posizione verticale da impostare, in punti.

Invio

Shape: questo elemento della pagina, per l'accodamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTransform(transform)`

Imposta la trasformazione dell'elemento della pagina con la trasformazione fornita.

L'aggiornamento della trasformazione di un gruppo modifica la trasformazione assoluta degli elementi della pagina al suo interno, il che può cambiare il loro aspetto visivo.

L'aggiornamento della trasformazione di un elemento di pagina all'interno di un gruppo modifica solo la trasformazione di quell'elemento, senza influire sulle trasformazioni del gruppo o di altri elementi di pagina al suo interno.

Per informazioni dettagliate su come le trasformazioni influiscono sull'aspetto visivo degli elementi della pagina, vedi getTransform().

Parametri

Nome	Tipo	Descrizione
`transform`	`AffineTransform`	La trasformazione impostata per questo elemento della pagina.

Invio

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

`setWidth(width)`

Imposta la larghezza dell'elemento in punti, ovvero la larghezza del suo riquadro delimitante quando l'elemento non è ruotato.

Parametri

Nome	Tipo	Descrizione
`width`	`Number`	La nuova larghezza dell'elemento di pagina da impostare, in punti.

Invio

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