Class Shape

Forma

Un PageElement che rappresenta una forma generica che non ha una classificazione più specifica. Include caselle di testo, rettangoli e altre forme predefinite.

Metodi

MetodoTipo restituitoBreve descrizione
alignOnPage(alignmentPosition)ShapeAllinea l'elemento alla posizione di allineamento specificata nella pagina.
bringForward()ShapePorta avanti di un elemento l'elemento della pagina.
bringToFront()ShapePorta l'elemento della pagina in primo piano.
duplicate()PageElementDuplica l'elemento della pagina.
getAutofit()Autofit|nullRestituisce l'Autofit del testo all'interno di questa forma.
getBorder()BorderRestituisce l'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()ContentAlignmentRestituisce l'ContentAlignment del testo nella forma.
getDescription()StringRestituisce la descrizione del testo alternativo dell'elemento della pagina.
getFill()FillRestituisce l'Fill della forma.
getHeight()Number|nullRestituisce l'altezza dell'elemento in punti, ovvero l'altezza del rettangolo di selezione dell'elemento quando l'elemento non è ruotato.
getInherentHeight()Number|nullRestituisce l'altezza intrinseca dell'elemento in punti.
getInherentWidth()Number|nullRestituisce la larghezza intrinseca dell'elemento in punti.
getLeft()NumberRestituisce la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
getLink()Link|nullRestituisce Link o null se non è presente alcun link.
getObjectId()StringRestituisce l'ID univoco per questo oggetto.
getPageElementType()PageElementTypeRestituisce il tipo dell'elemento della pagina, rappresentato come enumerazione PageElementType.
getParentGroup()Group|nullRestituisce il gruppo a cui appartiene questo elemento di pagina o null se l'elemento non si trova in un gruppo.
getParentPage()PageRestituisce la pagina in cui si trova questo elemento di pagina.
getParentPlaceholder()PageElement|nullRestituisce l'elemento della pagina principale del segnaposto.
getPlaceholderIndex()Integer|nullRestituisce l'indice del segnaposto della forma.
getPlaceholderType()PlaceholderTypeRestituisce il tipo di segnaposto della forma o PlaceholderType.NONE se la forma non è un segnaposto.
getRotation()NumberRestituisce l'angolo di rotazione in senso orario dell'elemento attorno al suo centro in gradi, dove zero gradi significa nessuna rotazione.
getShapeType()ShapeTypeRestituisce il tipo di forma.
getText()TextRangeRestituisce il contenuto testuale della forma.
getTitle()StringRestituisce il titolo del testo alternativo dell'elemento della pagina.
getTop()NumberRestituisce la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
getTransform()AffineTransformRestituisce la trasformazione dell'elemento della pagina.
getWidth()Number|nullRestituisce la larghezza dell'elemento in punti, ovvero la larghezza del rettangolo di selezione dell'elemento quando l'elemento non è ruotato.
preconcatenateTransform(transform)ShapePreconcatenates the provided transform to the existing transform of the page element.
remove()voidRimuove l'elemento della pagina.
removeLink()voidRimuove un Link.
replaceWithImage(blobSource)ImageSostituisce questa forma con un'immagine fornita da un BlobSource.
replaceWithImage(blobSource, crop)ImageSostituisce questa forma con un'immagine fornita da un BlobSource.
replaceWithImage(imageUrl)ImageSostituisce questa forma con un'immagine.
replaceWithImage(imageUrl, crop)ImageSostituisce questa forma con un'immagine.
replaceWithSheetsChart(sourceChart)SheetsChartSostituisce questa forma con un grafico di Fogli Google.
replaceWithSheetsChartAsImage(sourceChart)ImageSostituisce questa forma con un'immagine di un grafico di Fogli Google.
scaleHeight(ratio)ShapeScala l'altezza dell'elemento in base al rapporto specificato.
scaleWidth(ratio)ShapeScala la larghezza dell'elemento in base al rapporto specificato.
select()voidSeleziona solo PageElement nella presentazione attiva e rimuove qualsiasi selezione precedente.
select(replace)voidSeleziona il PageElement nella presentazione attiva.
sendBackward()ShapePorta indietro di un elemento l'elemento della pagina.
sendToBack()ShapePorta l'elemento della pagina in secondo piano.
setContentAlignment(contentAlignment)ShapeImposta l'ContentAlignment del testo nella forma.
setDescription(description)ShapeImposta la descrizione del testo alternativo dell'elemento della pagina.
setHeight(height)ShapeImposta l'altezza dell'elemento in punti, ovvero l'altezza del riquadro di selezione dell'elemento quando l'elemento non è ruotato.
setLeft(left)ShapeImposta la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
setLinkSlide(slideIndex)LinkImposta un Link sul Slide specificato utilizzando l'indice della slide basato su zero.
setLinkSlide(slide)LinkImposta un Link sul Slide specificato. Il link viene impostato dall'ID slide specificato.
setLinkSlide(slidePosition)LinkImposta un Link sul Slide specificato utilizzando la posizione relativa della slide.
setLinkUrl(url)LinkImposta un Link sulla stringa URL non vuota specificata.
setRotation(angle)ShapeImposta l'angolo di rotazione in senso orario dell'elemento attorno al suo centro in gradi.
setTitle(title)ShapeImposta il titolo del testo alternativo dell'elemento della pagina.
setTop(top)ShapeImposta la posizione verticale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non è ruotato.
setTransform(transform)ShapeImposta la trasformazione dell'elemento della pagina con la trasformazione fornita.
setWidth(width)ShapeImposta la larghezza dell'elemento in punti, ovvero la larghezza del riquadro di selezione dell'elemento quando l'elemento non è ruotato.

Documentazione dettagliata

alignOnPage(alignmentPosition)

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

Parametri

NomeTipoDescrizione
alignmentPositionAlignmentPositionLa posizione in cui allineare questo elemento della pagina.

Indietro

Shape: questo elemento della pagina, per il concatenamento.

bringForward()

Porta avanti di un elemento l'elemento della pagina.

L'elemento pagina non deve trovarsi in un gruppo.

Indietro

Shape: questo elemento della 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 della pagina in primo piano.

L'elemento pagina non deve trovarsi in un gruppo.

Indietro

Shape: questo elemento della 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 della pagina duplicata viene posizionato sulla stessa pagina nella stessa posizione dell'originale.

Indietro

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

getAutofit()

Restituisce l'Autofit del testo all'interno di questa forma. null se la forma non consente l'inserimento di testo.

Indietro

Autofit|null: 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 l'Border della forma.

Indietro

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.

Indietro

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 l'ContentAlignment del testo nella forma.

Indietro

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.

Indietro

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 l'Fill della forma.

Indietro

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 rettangolo di selezione dell'elemento quando l'elemento non è ruotato.

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

Indietro

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

Indietro

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

Autorizzazione

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

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

getInherentWidth()

Restituisce la larghezza intrinseca dell'elemento in punti.

La trasformazione dell'elemento della 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.

Indietro

Number|null: la larghezza intrinseca dell'elemento di pagina in punti o null se l'elemento di 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 è ruotato.

Indietro

Number: la posizione orizzontale di questo elemento in punti, a partire 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

Restituisce Link o null se non è presente alcun link. 

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()}`);
}

Indietro

Link|null: il Link o il 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 per questo oggetto. Gli ID oggetto utilizzati dalle pagine e dagli elementi della pagina condividono lo stesso spazio dei nomi.

Indietro

String: l'ID univoco per 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 dell'elemento della pagina, rappresentato come enumerazione PageElementType.

Indietro

PageElementType: il tipo dell'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 si trova in un gruppo.

Indietro

Group|null: 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.

Indietro

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

Indietro

PageElement|null: l'elemento della pagina principale di questo segnaposto della forma o 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 il proprio valore di indice univoco. Restituisce null se la forma non è un segnaposto.

Indietro

Integer|null: 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.

Indietro

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.

Indietro

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.

Indietro

ShapeType: il tipo di questa forma.

getText()

Restituisce il contenuto testuale della forma.

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

Indietro

TextRange: il contenuto testuale 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.

Indietro

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.

Indietro

Number: la posizione verticale di questo elemento in punti, a partire 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, preconcatenare la trasformazione di un elemento della pagina con le trasformazioni di tutti i relativi gruppi principali. Se l'elemento della pagina non si trova in un gruppo, la sua trasformazione assoluta è uguale al valore in questo campo.

Indietro

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 rettangolo di selezione dell'elemento quando l'elemento non è ruotato.

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

Indietro

Number|null: la larghezza intrinseca dell'elemento di pagina in punti o null se l'elemento di 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)

Preconcatenates the provided transform to the existing transform of the page element. 

newTransform = argument * existingTransform;

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

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

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

Parametri

NomeTipoDescrizione
transformAffineTransformLa trasformazione da preconcatenare alla trasformazione di questo elemento della pagina.

Indietro

Shape: questo elemento della 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 Group contiene solo uno o nessun elemento della pagina, viene rimosso anche il gruppo stesso.

Se un segnaposto PageElement viene rimosso da una slide master o da un layout, vengono rimossi anche tutti i segnaposto vuoti ereditati.

Autorizzazione

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

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

Rimuove un Link. 

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

replaceWithImage(blobSource)

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

L'immagine viene recuperata dal BlobSource fornito una sola volta al momento dell'inserimento e ne viene memorizzata una copia da visualizzare 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. 

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

NomeTipoDescrizione
blobSourceBlobSourceI dati immagine.

Indietro

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 da BlobSource una sola 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. 

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

NomeTipoDescrizione
blobSourceBlobSourceI dati immagine.
cropBooleanSe true, ritaglia l'immagine in modo che si adatti alle dimensioni della forma esistente. In caso contrario, l'immagine viene scalata e centrata.

Indietro

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 sola 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 accessibile pubblicamente e non più grande di 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

NomeTipoDescrizione
imageUrlStringL'URL dell'immagine da cui scaricarla.

Indietro

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'inserimento dell'immagine la recupera dall'URL una sola 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 non deve superare i 2 kB. L'URL stesso viene salvato con l'immagine e viene esposto tramite Image.getSourceUrl().

Parametri

NomeTipoDescrizione
imageUrlStringL'URL dell'immagine da cui scaricarla.
cropBooleanSe true, ritaglia l'immagine in modo che si adatti alle dimensioni della forma esistente. In caso contrario, l'immagine viene scalata e centrata.

Indietro

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

NomeTipoDescrizione
sourceChartEmbeddedChartIl grafico in un foglio di lavoro che sostituisce la forma.

Indietro

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

NomeTipoDescrizione
sourceChartEmbeddedChartIl grafico in un foglio di lavoro che sostituisce la forma.

Indietro

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 suo riquadro di selezione quando l'elemento non è ruotato.

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

Parametri

NomeTipoDescrizione
ratioNumberIl rapporto in base al quale scalare l'altezza di questo elemento della pagina.

Indietro

Shape: questo elemento della 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 suo riquadro di selezione quando l'elemento non è ruotato.

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

Parametri

NomeTipoDescrizione
ratioNumberIl rapporto in base al quale scalare la larghezza di questo elemento della pagina.

Indietro

Shape: questo elemento della 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 qualsiasi selezione precedente. Equivale a chiamare select(replace) con true.

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

In questo modo, Page padre di 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)

Seleziona il PageElement nella presentazione attiva.

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

Passa true a questo metodo per selezionare solo PageElement e rimuovere qualsiasi selezione precedente. In questo modo, l'elemento principale Page di PageElement viene impostato come current page selection.

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

Durante la selezione di un elemento della pagina utilizzando un parametro false devono essere soddisfatte le seguenti condizioni:

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

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

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

Parametri

NomeTipoDescrizione
replaceBooleanSe true, la selezione sostituisce qualsiasi selezione precedente; in caso contrario, 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()

Porta indietro di un elemento l'elemento della pagina.

L'elemento pagina non deve trovarsi in un gruppo.

Indietro

Shape: questo elemento della 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()

Porta l'elemento della pagina in secondo piano.

L'elemento pagina non deve trovarsi in un gruppo.

Indietro

Shape: questo elemento della 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 l'ContentAlignment del testo nella forma.

Questo metodo disattiva automaticamente le proprietà di adattamento automatico del testo nelle forme aggiornate.

Parametri

NomeTipoDescrizione
contentAlignmentContentAlignmentL'allineamento da impostare.

Indietro

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

Il metodo non è supportato per gli elementi Group. 

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

Parametri

NomeTipoDescrizione
descriptionStringLa stringa a cui impostare la descrizione del testo alternativo.

Indietro

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 selezione dell'elemento quando l'elemento non è ruotato.

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

Parametri

NomeTipoDescrizione
heightNumberLa nuova altezza da impostare per questo elemento della pagina, in punti.

Indietro

Shape: questo elemento della 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 è ruotato.

Parametri

NomeTipoDescrizione
leftNumberLa nuova posizione orizzontale da impostare, in punti.

Indietro

Shape: questo elemento della 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 Slide specificato utilizzando l'indice della slide basato su zero. 

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

Parametri

NomeTipoDescrizione
slideIndexIntegerL'indice in base zero della slide.

Indietro

Link: il 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 dall'ID slide specificato. 

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

Parametri

NomeTipoDescrizione
slideSlideL'account Slide da collegare.

Indietro

Link: il 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 slide. 

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

Parametri

NomeTipoDescrizione
slidePositionSlidePositionIl SlidePosition relativo.

Indietro

Link: il Link impostato.

Autorizzazione

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

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

setLinkUrl(url)

Imposta un Link sulla stringa URL non vuota specificata. 

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

Parametri

NomeTipoDescrizione
urlStringLa stringa URL.

Indietro

Link: il Link impostato.

Autorizzazione

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

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

setRotation(angle)

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

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

Parametri

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

Indietro

Shape: questo elemento della 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".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parametri

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

Indietro

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 è ruotato.

Parametri

NomeTipoDescrizione
topNumberLa nuova posizione verticale da impostare, in punti.

Indietro

Shape: questo elemento della 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 in quel gruppo, il che può modificarne l'aspetto visivo.

L'aggiornamento della trasformazione di un elemento della pagina che si trova in un gruppo modifica solo la trasformazione di quell'elemento della pagina; non influisce sulle trasformazioni del gruppo o di altri elementi della pagina nel gruppo.

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

Parametri

NomeTipoDescrizione
transformAffineTransformLa trasformazione impostata per questo elemento della pagina.

Indietro

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 selezione dell'elemento quando l'elemento non è ruotato.

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

Parametri

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

Indietro

Shape: questo elemento della 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