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 sulla pagina.
bringForward()ShapePorta l'elemento in avanti nella pagina di un elemento.
bringToFront()ShapePorta l'elemento di pagina in primo piano nella pagina.
duplicate()PageElementDuplica l'elemento della pagina.
getAutofit()AutofitRestituisce il Autofit del testo all'interno di questa forma.
getBorder()BorderRestituisce il Border della forma.
getConnectionSites()ConnectionSite[]Restituisce l'elenco di ConnectionSite nell'elemento della pagina o un elenco vuoto se l'elemento della pagina non ha siti di connessione.
getContentAlignment()ContentAlignmentRestituisce il ContentAlignment del testo nella forma.
getDescription()StringRestituisce la descrizione del testo alternativo dell'elemento della pagina.
getFill()FillRestituisce il Fill della forma.
getHeight()NumberRestituisce l'altezza in punti dell'elemento, ovvero l'altezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.
getInherentHeight()NumberRestituisce l'altezza intrinseca dell'elemento in punti.
getInherentWidth()NumberRestituisce la larghezza intrinseca dell'elemento in punti.
getLeft()NumberRestituisce la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione.
getLink()LinkRestituisce Link o null in assenza di link.
getObjectId()StringRestituisce l'ID univoco dell'oggetto.
getPageElementType()PageElementTypeRestituisce il tipo di elemento della pagina, rappresentato come un enum PageElementType.
getParentGroup()GroupRestituisce il gruppo a cui appartiene questo elemento di pagina o null se l'elemento non fa parte di un gruppo.
getParentPage()PageRestituisce la pagina su cui si trova questo elemento di pagina.
getParentPlaceholder()PageElementRestituisce l'elemento di pagina principale del segnaposto.
getPlaceholderIndex()IntegerRestituisce l'indice 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 orario dell'elemento intorno 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 ha rotazione.
getTransform()AffineTransformRestituisce la trasformazione dell'elemento della pagina.
getWidth()NumberRestituisce la larghezza in punti dell'elemento, ovvero la larghezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.
preconcatenateTransform(transform)ShapePreconcatena la trasformazione fornita alla trasformazione esistente dell'elemento della pagina.
remove()voidRimuove l'elemento della pagina.
removeLink()voidRimuove un Link.
replaceWithImage(blobSource)ImageSostituisce questa forma con un'immagine fornita da BlobSource.
replaceWithImage(blobSource, crop)ImageSostituisce questa forma con un'immagine fornita da 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 l'immagine di un grafico di Fogli Google.
scaleHeight(ratio)ShapeRidimensiona l'altezza dell'elemento in base al rapporto specificato.
scaleWidth(ratio)ShapeRidimensiona la larghezza dell'elemento in base al rapporto specificato.
select()voidConsente di selezionare solo PageElement nella presentazione attiva e di rimuovere eventuali selezioni precedenti.
select(replace)voidConsente di selezionare PageElement nella presentazione attiva.
sendBackward()ShapeInvia l'elemento indietro sulla pagina di un elemento.
sendToBack()ShapeInvia l'elemento di pagina in fondo alla pagina.
setContentAlignment(contentAlignment)ShapeImposta il ContentAlignment del testo nella forma.
setDescription(description)ShapeImposta la descrizione del testo alternativo dell'elemento della pagina.
setHeight(height)ShapeConsente di impostare l'altezza in punti dell'elemento, ovvero l'altezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.
setLeft(left)ShapeConsente di impostare la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione.
setLinkSlide(slideIndex)LinkImposta un Link per il Slide specificato utilizzando l'indice in base zero della slide.
setLinkSlide(slide)LinkImposta un Link sul Slide specificato, il link viene impostato in base all'ID slide specificato.
setLinkSlide(slidePosition)LinkImposta un Link per il Slide specificato utilizzando la posizione relativa della slide.
setLinkUrl(url)LinkImposta un Link sulla stringa URL non vuota specificata.
setRotation(angle)ShapeConsente di impostare l'angolo di rotazione orario dell'elemento intorno al centro in gradi.
setTitle(title)ShapeImposta il titolo del testo alternativo dell'elemento della pagina.
setTop(top)ShapeConsente 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)ShapeImposta la trasformazione dell'elemento di pagina con la trasformazione fornita.
setWidth(width)ShapeConsente di impostare la larghezza in punti dell'elemento, ovvero la larghezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.

Documentazione dettagliata

alignOnPage(alignmentPosition)

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

Parametri

NomeTipoDescrizione
alignmentPositionAlignmentPositionLa posizione in cui allineare questo elemento sulla pagina.

Ritorni

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

Ritorni

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

Ritorni

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

Ritorni

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 il Autofit del testo all'interno di questa forma. Questo è null se la forma non consente testo.

Ritorni

Autofit: l'adattamento automatico del testo all'interno della forma.

Autorizzazione

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

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

getBorder()

Restituisce il Border della forma.

Ritorni

Border: l'impostazione del bordo di questa forma.

Autorizzazione

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

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

getConnectionSites()

Restituisce l'elenco di ConnectionSite nell'elemento della pagina o un elenco vuoto se l'elemento della pagina non ha siti di connessione.

Ritorni

ConnectionSite[]: l'elenco dei siti di connessione, che potrebbe essere vuoto se questo elemento non ha siti di connessione.

Autorizzazione

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

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

getContentAlignment()

Restituisce il ContentAlignment del testo nella forma.

Ritorni

ContentAlignment: l'allineamento del testo all'interno della 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 è combinata con il titolo per visualizzare e leggere il testo alternativo.

Ritorni

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

getFill()

Restituisce il Fill della forma.

Ritorni

Fill: l'impostazione di riempimento di questa forma.

Autorizzazione

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

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

getHeight()

Restituisce l'altezza in punti dell'elemento, ovvero l'altezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.

Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta i limiti di dimensioni e posizionamento.

Ritorni

Number: l'altezza intrinseca dell'elemento di pagina in punti o null se l'elemento 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 alla sua dimensione intrinseca. Utilizza le dimensioni intrinseche insieme alla trasformazione dell'elemento per determinare l'aspetto visivo finale dell'elemento.

Ritorni

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

Autorizzazione

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

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

getInherentWidth()

Restituisce la larghezza intrinseca dell'elemento in punti.

La trasformazione dell'elemento di pagina è relativa alla sua dimensione intrinseca. Utilizza le dimensioni intrinseche insieme alla trasformazione dell'elemento per determinare l'aspetto visivo finale dell'elemento.

Ritorni

Number: la larghezza intrinseca dell'elemento di pagina in punti o null se l'elemento non ha una larghezza.

Autorizzazione

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

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

getLeft()

Restituisce la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione.

Ritorni

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

Restituisce Link o null in assenza di link.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Ritorni

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 dell'oggetto. Gli ID oggetto utilizzati da pagine ed elementi di pagina condividono lo stesso spazio dei nomi.

Ritorni

String: l'ID univoco dell'oggetto.

Autorizzazione

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

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

getPageElementType()

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

Ritorni

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.

Ritorni

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.

Ritorni

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 la forma non è un segnaposto o non ha un padre.

Ritorni

PageElement: l'elemento della pagina principale di questo segnaposto di forma o null se la forma non è un segnaposto o non ne 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 segnaposto della forma. Se nella stessa pagina sono presenti due o più istanze degli stessi tipi di segnaposto, ognuna avrà il proprio valore di indice univoco. Restituisce null se la forma non è un segnaposto.

Ritorni

Integer: indice segnaposto di questa forma o null se la forma non è un segnaposto.

Autorizzazione

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

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

getPlaceholderType()

Restituisce il tipo di segnaposto della forma o PlaceholderType.NONE se la forma non è un segnaposto.

Ritorni

PlaceholderType: il tipo di segnaposto 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 orario dell'elemento intorno al suo centro in gradi, dove zero gradi significa nessuna rotazione.

Ritorni

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.

Ritorni

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.

Ritorni

TextRange: i contenuti testuali di questa forma.

Autorizzazione

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

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

getTitle()

Restituisce il titolo del testo alternativo dell'elemento della pagina. Il titolo viene combinato con la descrizione per visualizzare e leggere il testo alternativo.

Ritorni

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.

Ritorni

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. Per calcolare la trasformazione assoluta, preconcatena la trasformazione di un elemento di pagina con le trasformazioni di tutti i suoi gruppi principali. Se l'elemento di pagina non si trova in un gruppo, la sua trasformazione assoluta è uguale al valore in questo campo.

Ritorni

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 i limiti di dimensioni e posizionamento.

Ritorni

Number: la larghezza intrinseca dell'elemento di pagina in punti o null se l'elemento non ha una larghezza.

Autorizzazione

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform

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

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

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

Parametri

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

Ritorni

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

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

Autorizzazione

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

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

Rimuove un Link.

shape.removeLink();

replaceWithImage(blobSource)

Sostituisce questa forma con un'immagine fornita da 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, l'immagine viene ridimensionata e centrata rispetto alle dimensioni della forma esistente.

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

Parametri

NomeTipoDescrizione
blobSourceBlobSourceI dati dell'immagine.

Ritorni

Image: il valore Image che ha sostituito la forma.

Autorizzazione

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

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

replaceWithImage(blobSource, crop)

Sostituisce questa forma con un'immagine fornita da BlobSource.

Se inserisci l'immagine, questa viene recuperata da BlobSource una volta e viene archiviata 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.

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

Parametri

NomeTipoDescrizione
blobSourceBlobSourceI dati dell'immagine.
cropBooleanSe true, ritaglia l'immagine per adattarla alle dimensioni della forma esistente. In caso contrario, l'immagine viene ridimensionata e centrata.

Ritorni

Image: il valore Image che ha sostituito la forma.

Autorizzazione

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

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

replaceWithImage(imageUrl)

Sostituisce questa forma con un'immagine.

L'inserimento dell'immagine ne recupera una sola volta dall'URL 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.

L'URL fornito deve essere accessibile pubblicamente e non deve superare i 2 kB. L'URL viene salvato con l'immagine ed esposto tramite Image.getSourceUrl().

Per mantenere le proporzioni, l'immagine viene ridimensionata e centrata rispetto alle dimensioni della forma esistente.

Parametri

NomeTipoDescrizione
imageUrlStringL'URL dell'immagine da cui scaricare l'immagine.

Ritorni

Image: il valore Image che ha sostituito la forma.

Autorizzazione

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

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

replaceWithImage(imageUrl, crop)

Sostituisce questa forma con un'immagine.

L'inserimento dell'immagine ne recupera una sola volta dall'URL 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.

L'URL fornito non deve essere superiore a 2 kB. L'URL stesso viene salvato con l'immagine ed esposto tramite Image.getSourceUrl().

Parametri

NomeTipoDescrizione
imageUrlStringL'URL dell'immagine da cui scaricare l'immagine.
cropBooleanSe true, ritaglia l'immagine per adattarla alle dimensioni della forma esistente. In caso contrario, l'immagine viene ridimensionata e centrata.

Ritorni

Image: il valore Image che ha sostituito la forma.

Autorizzazione

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

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

replaceWithSheetsChart(sourceChart)

Sostituisce questa forma con un grafico di Fogli Google.

Il grafico è collegato al grafico di origine di Fogli Google, quindi può essere aggiornato. Altri collaboratori possono visualizzare il link al foglio di lavoro di origine.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

Parametri

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

Ritorni

SheetsChart: il grafico che ha sostituito la forma.

Autorizzazione

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

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

replaceWithSheetsChartAsImage(sourceChart)

Sostituisce questa forma con l'immagine di un grafico di Fogli Google.

Per mantenere le proporzioni del grafico di Fogli Google, l'immagine 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.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

Parametri

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

Ritorni

Image: l'immagine del grafico che ha sostituito la forma.

Autorizzazione

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

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

scaleHeight(ratio)

Ridimensiona l'altezza dell'elemento in base al rapporto specificato. L'altezza dell'elemento è l'altezza del riquadro di delimitazione 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 i limiti di dimensioni e posizionamento.

Parametri

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

Ritorni

Shape: 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 corrisponde a quella del riquadro di delimitazione 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 i limiti di dimensioni e posizionamento.

Parametri

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

Ritorni

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

Consente di selezionare solo PageElement nella presentazione attiva e di rimuovere eventuali selezioni precedenti. Equivale a chiamare select(replace) con true.

Uno script può accedere solo alla selezione dell'utente che lo esegue e solo se 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 qualsiasi selezione precedente. In questo modo viene impostato anche l'elemento principale Page di PageElement come current page selection.

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

Durante la selezione di un elemento di 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 questo motivo, l'approccio preferito è selezionare prima l'elemento Page principale utilizzando Page.selectAsCurrentPage(), quindi selezionare 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

NomeTipoDescrizione
replaceBooleanSe true, la selezione sostituisce qualsiasi selezione precedente; altrimenti la selezione viene aggiunta a qualsiasi selezione precedente.

Autorizzazione

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

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

sendBackward()

Invia l'elemento indietro sulla pagina di un elemento.

L'elemento di pagina non deve essere in un gruppo.

Ritorni

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

Ritorni

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

setContentAlignment(contentAlignment)

Imposta il 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.

Ritorni

Shape: questa forma, per il concatenamento.

Autorizzazione

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

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

setDescription(description)

Imposta la descrizione del testo alternativo dell'elemento 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

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

Ritorni

Shape: questo elemento di pagina.

Autorizzazione

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

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

setHeight(height)

Consente di impostare l'altezza in punti dell'elemento, ovvero l'altezza del riquadro di delimitazione dell'elemento quando l'elemento non ha rotazione.

Questo metodo non è compatibile con tutti gli elementi della pagina. Per sapere quali elementi della pagina non sono compatibili con questo metodo, consulta i limiti di dimensioni e posizionamento.

Parametri

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

Ritorni

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

setLeft(left)

Consente di impostare la posizione orizzontale dell'elemento in punti, misurata dall'angolo in alto a sinistra della pagina quando l'elemento non ha rotazione.

Parametri

NomeTipoDescrizione
leftNumberLa nuova posizione orizzontale da impostare, in punti.

Ritorni

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

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

NomeTipoDescrizione
slideIndexIntegerL'indice in base zero della slide.

Ritorni

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

NomeTipoDescrizione
slideSlideSlide da collegare.

Ritorni

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

NomeTipoDescrizione
slidePositionSlidePositionL'elemento SlidePosition relativo.

Ritorni

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

NomeTipoDescrizione
urlStringLa stringa dell'URL.

Ritorni

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 i limiti di dimensioni e posizionamento.

Parametri

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

Ritorni

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

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

Ritorni

Shape: questo elemento di pagina.

Autorizzazione

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

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

setTop(top)

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

NomeTipoDescrizione
topNumberLa nuova posizione verticale da impostare, in punti.

Ritorni

Shape: 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 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 di pagina che si trova in un gruppo modifica solo la trasformazione dell'elemento di pagina in questione; non influisce sulle trasformazioni del gruppo o di altri elementi della pagina del gruppo.

Per maggiori dettagli sull'impatto delle trasformazioni sull'aspetto visivo degli elementi della pagina, consulta getTransform().

Parametri

NomeTipoDescrizione
transformAffineTransformLa trasformazione impostata per questo elemento della pagina.

Ritorni

Shape: questo elemento, per il concatenamento.

Autorizzazione

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

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

setWidth(width)

Consente di impostare 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 i limiti di dimensioni e posizionamento.

Parametri

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

Ritorni

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