Un layout in una presentazione.
Ogni layout funge da modello per le slide che lo ereditano, determinando come i contenuti le diapositive siano organizzate e definite.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getBackground() | PageBackground | Recupera lo sfondo della pagina. |
getColorScheme() | ColorScheme | Consente di recuperare l'elemento ColorScheme associato alla pagina. |
getGroups() | Group[] | Restituisce l'elenco di Group oggetti nella pagina. |
getImages() | Image[] | Restituisce l'elenco di Image oggetti nella pagina. |
getLayoutName() | String | Ottiene il nome del layout. |
getLines() | Line[] | Restituisce l'elenco di Line oggetti nella pagina. |
getMaster() | Master | Ottiene lo schema su cui si basa il layout. |
getObjectId() | String | Recupera l'ID univoco della pagina. |
getPageElementById(id) | PageElement | Restituisce PageElement nella pagina con l'ID specificato o null se non ne esiste nessuno. |
getPageElements() | PageElement[] | Restituisce l'elenco di PageElement oggetti visualizzati nella pagina. |
getPageType() | PageType | Ottiene il tipo di pagina. |
getPlaceholder(placeholderType) | PageElement | Restituisce l'oggetto segnaposto PageElement per un valore PlaceholderType specificato o
null se non è presente un segnaposto corrispondente. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | Restituisce l'oggetto segnaposto PageElement per un PlaceholderType specificato e
un indice segnaposto o null se il segnaposto non è presente. |
getPlaceholders() | PageElement[] | Restituisce l'elenco di oggetti segnaposto PageElement nella pagina. |
getShapes() | Shape[] | Restituisce l'elenco di Shape oggetti nella pagina. |
getSheetsCharts() | SheetsChart[] | Restituisce l'elenco di SheetsChart oggetti nella pagina. |
getTables() | Table[] | Restituisce l'elenco di Table oggetti nella pagina. |
getVideos() | Video[] | Restituisce l'elenco di Video oggetti nella pagina. |
getWordArts() | WordArt[] | Restituisce l'elenco di WordArt oggetti nella pagina. |
group(pageElements) | Group | Raggruppa tutti gli elementi della pagina specificati. |
insertGroup(group) | Group | Inserisce nella pagina una copia del valore Group fornito. |
insertImage(blobSource) | Image | Inserisce un'immagine nell'angolo superiore sinistro della pagina con una dimensione predefinita BLOB di immagine. |
insertImage(blobSource, left, top, width, height) | Image | Inserisce nella pagina un'immagine con la posizione e le dimensioni specificate dal blob dell'immagine specificato. |
insertImage(image) | Image | Inserisce nella pagina una copia del valore Image fornito. |
insertImage(imageUrl) | Image | Inserisce nell'angolo in alto a sinistra della pagina un'immagine con una dimensione predefinita proveniente dall'URL fornito. |
insertImage(imageUrl, left, top, width, height) | Image | Inserisce nella pagina un'immagine con la posizione e le dimensioni fornite dall'URL fornito. |
insertLine(line) | Line | Inserisce nella pagina una copia del valore Line fornito. |
insertLine(lineCategory, startConnectionSite, endConnectionSite) | Line | Inserisce nella pagina una riga che collega due connection sites . |
insertLine(lineCategory, startLeft, startTop, endLeft, endTop) | Line | Inserisce una riga nella pagina. |
insertPageElement(pageElement) | PageElement | Inserisce nella pagina una copia del valore PageElement fornito. |
insertShape(shape) | Shape | Inserisce nella pagina una copia del valore Shape fornito. |
insertShape(shapeType) | Shape | Inserisce una forma nella pagina. |
insertShape(shapeType, left, top, width, height) | Shape | Inserisce una forma nella pagina. |
insertSheetsChart(sourceChart) | SheetsChart | Inserisce nella pagina un grafico di Fogli Google. |
insertSheetsChart(sourceChart, left, top, width, height) | SheetsChart | Inserisce nella pagina un grafico di Fogli Google con la posizione e le dimensioni fornite. |
insertSheetsChart(sheetsChart) | SheetsChart | Inserisce nella pagina una copia del valore SheetsChart fornito. |
insertSheetsChartAsImage(sourceChart) | Image | Inserisce un grafico di Fogli Google come Image nella pagina. |
insertSheetsChartAsImage(sourceChart, left, top, width, height) | Image | Inserisce un grafico di Fogli Google come Image nella pagina con la posizione e
dimensioni. |
insertTable(numRows, numColumns) | Table | Inserisce una tabella nella pagina. |
insertTable(numRows, numColumns, left, top, width, height) | Table | Inserisce nella pagina una tabella con la posizione e le dimensioni fornite. |
insertTable(table) | Table | Inserisce nella pagina una copia del valore Table fornito. |
insertTextBox(text) | Shape | Inserisce nella pagina una casella di testo Shape contenente la stringa fornita. |
insertTextBox(text, left, top, width, height) | Shape | Inserisce nella pagina una casella di testo Shape contenente la stringa fornita. |
insertVideo(videoUrl) | Video | Inserisce un video nell'angolo in alto a sinistra della pagina con una dimensione predefinita. |
insertVideo(videoUrl, left, top, width, height) | Video | Inserisce nella pagina un video con la posizione e le dimensioni specificate. |
insertVideo(video) | Video | Inserisce nella pagina una copia del valore Video fornito. |
insertWordArt(wordArt) | WordArt | Inserisce nella pagina una copia del valore WordArt fornito. |
remove() | void | Rimuove la pagina. |
replaceAllText(findText, replaceText) | Integer | Sostituisce tutte le istanze di testo corrispondenti a Trova testo con Sostituisci testo. |
replaceAllText(findText, replaceText, matchCase) | Integer | Sostituisce tutte le istanze di testo corrispondenti a Trova testo con Sostituisci testo. |
selectAsCurrentPage() | void | Seleziona Page nella presentazione attiva come current page selection e rimuove la selezione precedente. |
Documentazione dettagliata
getBackground()
Recupera lo sfondo della pagina.
Invio
PageBackground
: sfondo 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
getColorScheme()
Consente di recuperare l'elemento ColorScheme
associato alla pagina.
Invio
ColorScheme
: la combinazione di colori 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
getGroups()
getImages()
getLayoutName()
Ottiene il nome del layout.
Invio
String
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLines()
getMaster()
getObjectId()
Recupera l'ID univoco della pagina. Gli ID oggetto utilizzati da pagine ed elementi di pagina condividono lo stesso nello spazio dei nomi.
Invio
String
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
Restituisce PageElement
nella pagina con l'ID specificato o null
se non ne esiste nessuno.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
id | String | L'ID dell'elemento di pagina recuperato. |
Invio
PageElement
: l'elemento di pagina con l'ID specificato.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElements()
Restituisce l'elenco di PageElement
oggetti visualizzati nella pagina.
Invio
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageType()
getPlaceholder(placeholderType)
Restituisce l'oggetto segnaposto PageElement
per un valore PlaceholderType
specificato o
null
se non è presente un segnaposto corrispondente.
Se sono presenti più segnaposto dello stesso tipo, viene restituito quello con dell'indice segnaposto. Se sono presenti più segnaposto corrispondenti con lo stesso indice, verrà restituito il primo segnaposto dalla raccolta degli elementi di pagina della pagina.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
placeholderType | PlaceholderType |
Invio
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType, placeholderIndex)
Restituisce l'oggetto segnaposto PageElement
per un PlaceholderType
specificato e
un indice segnaposto o null
se il segnaposto non è presente.
Se sono presenti più segnaposto con lo stesso tipo e indice, restituisce il primo segnaposto dalla raccolta degli elementi della pagina della pagina.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
Invio
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholders()
Restituisce l'elenco di oggetti segnaposto PageElement
nella pagina.
var master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);
Invio
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapes()
getSheetsCharts()
Restituisce l'elenco di SheetsChart
oggetti nella pagina.
Invio
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTables()
getVideos()
getWordArts()
group(pageElements)
Raggruppa tutti gli elementi della pagina specificati.
Sulla stessa pagina devono essere presenti almeno due elementi che non si trovano già in un'altra
gruppo. Alcuni elementi della pagina, come Videos
, Tables
e placeholder Shapes
, non possono essere raggruppati.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
pageElements | PageElement[] | Gli elementi da raggruppare. |
Invio
Group
: il nuovo gruppo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertGroup(group)
Inserisce nella pagina una copia del valore Group
fornito.
La posizione dell'elemento inserito in questa pagina è determinata dalla posizione nella rispettiva pagina.
Se l'elemento fornito è un segnaposto che viene copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine principali o di layout ereditano anche l'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da una presentazione diversa, le proprietà che ereditano dalle pagine principali o di layout vengono copiate sull'elemento dalla sorgente una presentazione.
// Copy a group between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var group = otherPresentationSlide.getGroups()[0]; currentPresentationSlide.insertGroup(group); // Also available for Layout, Master, and Page.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
group | Group | Il gruppo da copiare e inserire. |
Invio
Group
: il gruppo inserito.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource)
Inserisce un'immagine nell'angolo superiore sinistro della pagina con una dimensione predefinita BLOB di immagine.
Se inserisci l'immagine, questa viene recuperata da BlobSource
una volta e viene archiviata una copia
all'interno della presentazione. Le immagini devono essere inferiori a 50 MB e non più di 25
megapixel e devono essere in formato PNG, JPEG o GIF.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); slide.insertImage(image);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blobSource | BlobSource | I dati dell'immagine. |
Invio
Image
: l'immagine inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource, left, top, width, height)
Inserisce nella pagina un'immagine con la posizione e le dimensioni specificate dal blob dell'immagine specificato.
L'immagine viene recuperata una volta dal BlobSource
fornito al momento dell'inserimento e una copia
vengono memorizzati per essere visualizzati 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 nel rispetto alla dimensione specificata.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); var position = {left: 0, top: 0}; var size = {width: 300, height: 100}; slide.insertImage(image, position.left, position.top, size.width, size.height);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blobSource | BlobSource | I dati dell'immagine. |
left | Number | La posizione orizzontale dell'immagine in punti, misurata dall'angolo in alto a sinistra. della pagina. |
top | Number | La posizione verticale dell'immagine in punti, misurata dall'angolo in alto a sinistra di della pagina. |
width | Number | La larghezza dell'immagine in punti. |
height | Number | L'altezza dell'immagine in punti. |
Invio
Image
: l'immagine inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(image)
Inserisce nella pagina una copia del valore Image
fornito.
La posizione delle immagini inserite in questa pagina è determinata dalla posizione dell'immagine di origine sulla rispettiva pagina.
Se l'immagine fornita è un segnaposto che viene copiato dalla presentazione corrente, che ereditano anche le proprietà dalle pagine principali o di layout ereditano l'immagine inserita.
Se l'immagine fornita è un segnaposto copiato da una presentazione diversa, le proprietà che ereditano dalle pagine principali o di layout vengono copiate nell'immagine dalla sorgente una presentazione. Se l'immagine segnaposto copiata è vuota, non viene inserito nulla nella destinazione una presentazione.
// Copy an image between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var image = otherPresentationSlide.getImages[0]; currentPresentationSlide.insertImage(image);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
image | Image | L'immagine da copiare e inserire. |
Invio
Image
: l'immagine inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl)
Inserisce nell'angolo in alto a sinistra della pagina un'immagine con una dimensione predefinita proveniente dall'URL fornito.
Inserendo l'immagine, questa viene recuperata dall'URL una volta sola e ne viene archiviata una copia per la visualizzazione all'interno del una presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
L'URL fornito deve essere accessibile pubblicamente e non deve superare i 2 kB. L'URL stesso viene salvato
con l'immagine ed esposto tramite Image.getSourceUrl()
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
imageUrl | String | L'URL dell'immagine. |
Invio
Image
: l'immagine inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl, left, top, width, height)
Inserisce nella pagina un'immagine con la posizione e le dimensioni fornite dall'URL fornito.
Inserendo l'immagine, questa viene recuperata dall'URL una volta sola e ne viene archiviata una copia per la visualizzazione all'interno del una presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
L'URL fornito deve essere accessibile pubblicamente e non deve superare i 2 kB. L'URL stesso viene salvato
con l'immagine ed esposto tramite Image.getSourceUrl()
.
Per mantenere le proporzioni, l'immagine viene ridimensionata e centrata nel rispetto alla dimensione specificata.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
imageUrl | String | L'URL dell'immagine. |
left | Number | La posizione orizzontale dell'immagine in punti, misurata dall'angolo in alto a sinistra. della pagina. |
top | Number | La posizione verticale dell'immagine in punti, misurata dall'angolo in alto a sinistra di della pagina. |
width | Number | La larghezza dell'immagine in punti. |
height | Number | L'altezza dell'immagine in punti. |
Invio
Image
: l'immagine inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(line)
Inserisce nella pagina una copia del valore Line
fornito.
La posizione dell'elemento inserito in questa pagina è determinata dalla posizione nella rispettiva pagina.
Se l'elemento fornito è un segnaposto che viene copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine principali o di layout ereditano anche l'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da una presentazione diversa, le proprietà che ereditano dalle pagine principali o di layout vengono copiate sull'elemento dalla sorgente una presentazione.
// Copy a line between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
line | Line | La riga da copiare e inserire. |
Invio
Line
: la riga inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startConnectionSite, endConnectionSite)
Inserisce nella pagina una riga che collega due connection sites
. I due
i siti di connessione devono essere su questa pagina.
// Insert a line in the first slide of the presentation connecting two shapes. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
lineCategory | LineCategory | La categoria della riga da inserire. |
startConnectionSite | ConnectionSite | Il sito di connessione a cui deve essere collegato l'inizio della linea. |
endConnectionSite | ConnectionSite | Il sito di connessione a cui deve essere collegata l'estremità della linea. |
Invio
Line
: la riga inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)
Inserisce una riga nella pagina.
// Insert a line in the first slide of the presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var startPoint = {left: 10, top: 10}; var endPoint = {left: 40, top: 40}; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
lineCategory | LineCategory | La categoria della riga da inserire. |
startLeft | Number | La posizione orizzontale del punto iniziale della linea, misurata in punti. dall'angolo in alto a sinistra della pagina. |
startTop | Number | La posizione verticale del punto iniziale della linea, misurata in punti a partire da nell'angolo in alto a sinistra della pagina. |
endLeft | Number | La posizione orizzontale del punto finale della linea, misurata in punti a partire da nell'angolo in alto a sinistra della pagina. |
endTop | Number | La posizione verticale del punto finale della linea, misurata in punti a partire dalla nell'angolo in alto a sinistra della pagina. |
Invio
Line
: la riga inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertPageElement(pageElement)
Inserisce nella pagina una copia del valore PageElement
fornito.
La posizione dell'elemento inserito in questa pagina è determinata dalla posizione nella rispettiva pagina.
Se l'elemento fornito è un segnaposto che viene copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine principali o di layout ereditano anche l'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da una presentazione diversa, le proprietà che ereditano dalle pagine principali o di layout vengono copiate sull'elemento dalla sorgente una presentazione.
// Copy a page element between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
pageElement | PageElement | L'elemento di pagina da copiare e inserire. |
Invio
PageElement
: l'elemento di pagina inserito.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shape)
Inserisce nella pagina una copia del valore Shape
fornito.
La posizione dell'elemento inserito in questa pagina è determinata dalla posizione nella rispettiva pagina.
Se l'elemento fornito è un segnaposto che viene copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine principali o di layout ereditano anche l'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da una presentazione diversa, le proprietà che ereditano dalle pagine principali o di layout vengono copiate sull'elemento dalla sorgente una presentazione.
// Copy a shape between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var shape = otherPresentationSlide.getShapes[0]; currentPresentationSlide.insertShape(shape); // Also available for Layout, Master, and Page.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
shape | Shape | La forma da copiare e inserire. |
Invio
Shape
: la forma inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType)
Inserisce una forma nella pagina.
La forma viene inserita con una dimensione predefinita nell'angolo in alto a sinistra della pagina.
// Insert a shape in the first slide of the presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
shapeType | ShapeType | Il tipo di forma da inserire. |
Invio
Shape
: la forma inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType, left, top, width, height)
Inserisce una forma nella pagina.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
shapeType | ShapeType | Il tipo di forma da inserire. |
left | Number | La posizione orizzontale della forma, misurata dall'angolo in alto a sinistra della . |
top | Number | La posizione verticale della forma, misurata dall'angolo in alto a sinistra della pagina. |
width | Number | La larghezza della forma. |
height | Number | L'altezza della forma. |
Invio
Shape
: la forma inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart)
Inserisce nella pagina un grafico di Fogli Google.
Il grafico viene inserito con una dimensione predefinita nell'angolo in alto a sinistra della pagina.
Il grafico inserito è collegato al grafico di origine di Fogli Google, che consente di essere aggiornato. Gli altri collaboratori possono visualizzare il link al foglio di lavoro di origine.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sourceChart | EmbeddedChart | Il grafico in un foglio di lavoro da inserire nella pagina. |
Invio
SheetsChart
: il grafico inserito nella 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
insertSheetsChart(sourceChart, left, top, width, height)
Inserisce nella pagina un grafico di Fogli Google con la posizione e le dimensioni fornite.
Per mantenere le proporzioni del grafico, quest'ultimo viene ridimensionato e centrato in modo rispettoso alla dimensione specificata.
Il grafico inserito è collegato al grafico di origine di Fogli Google, che consente di essere aggiornato. Gli altri collaboratori possono visualizzare il link al foglio di lavoro di origine.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChart( chart, position.left, position.top, size.width, size.height);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sourceChart | EmbeddedChart | Il grafico in un foglio di lavoro da inserire nella pagina. |
left | Number | La posizione orizzontale del grafico in punti, misurata dall'angolo in alto a sinistra. della pagina. |
top | Number | La posizione verticale del grafico in punti, misurata dall'angolo in alto a sinistra di della pagina. |
width | Number | La larghezza del grafico in punti. |
height | Number | L'altezza del grafico in punti. |
Invio
SheetsChart
: il grafico inserito nella 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
insertSheetsChart(sheetsChart)
Inserisce nella pagina una copia del valore SheetsChart
fornito.
La posizione dell'elemento inserito in questa pagina è determinata dalla posizione nella rispettiva pagina.
Se l'elemento fornito è un segnaposto che viene copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine principali o di layout ereditano anche l'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da una presentazione diversa, le proprietà che ereditano dalle pagine principali o di layout vengono copiate sull'elemento dalla sorgente una presentazione.
// Copy a sheets chart between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sheetsChart | SheetsChart | Il grafico a fogli da copiare e inserire. |
Invio
SheetsChart
: il grafico di Fogli inserito.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart)
Inserisce un grafico di Fogli Google come Image
nella pagina.
L'immagine del grafico viene inserita con una dimensione predefinita nell'angolo in alto a sinistra della pagina.
L'immagine del grafico inserita non è collegata al grafico di Fogli Google di origine.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sourceChart | EmbeddedChart | Il grafico in un foglio di lavoro da inserire nella pagina. |
Invio
Image
: l'immagine inserita del grafico nella 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
insertSheetsChartAsImage(sourceChart, left, top, width, height)
Inserisce un grafico di Fogli Google come Image
nella pagina con la posizione e
dimensioni.
Per mantenere le proporzioni dell'immagine del grafico, l'immagine viene ridimensionata e centrata con rispetto alle dimensioni fornite.
L'immagine inserita del grafico non è collegata al grafico di Fogli Google di origine.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChartAsImage( chart, position.left, position.right, size.width, size.height);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sourceChart | EmbeddedChart | Il grafico in un foglio di lavoro da inserire nella pagina. |
left | Number | La posizione orizzontale del grafico in punti, misurata dall'angolo in alto a sinistra. della pagina. |
top | Number | La posizione verticale del grafico in punti, misurata dall'angolo in alto a sinistra di della pagina. |
width | Number | La larghezza del grafico in punti. |
height | Number | L'altezza del grafico in punti. |
Invio
Image
: l'immagine inserita del grafico nella 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
insertTable(numRows, numColumns)
Inserisce una tabella nella pagina.
La tabella è centrata sulla pagina con dimensioni predefinite e righe e colonne distribuite uniformemente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
numRows | Integer | Il numero di righe nella tabella. |
numColumns | Integer | Il numero di colonne nella tabella. |
Invio
Table
: la tabella inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns, left, top, width, height)
Inserisce nella pagina una tabella con la posizione e le dimensioni fornite.
Righe e colonne vengono distribuite in modo uniforme nella tabella creata.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
numRows | Integer | Il numero di righe nella tabella. |
numColumns | Integer | Il numero di colonne nella tabella. |
left | Number | La posizione orizzontale della tabella, misurata dall'angolo in alto a sinistra della . |
top | Number | La posizione verticale della tabella, misurata dall'angolo in alto a sinistra della pagina. |
width | Number | La larghezza della tabella. |
height | Number | L'altezza minima della tabella. L'altezza effettiva della tabella visualizzata dipende in base a fattori quali le dimensioni del carattere. |
Invio
Table
: la tabella inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(table)
Inserisce nella pagina una copia del valore Table
fornito.
La posizione dell'elemento inserito in questa pagina è determinata dalla posizione nella rispettiva pagina.
Se l'elemento fornito è un segnaposto che viene copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine principali o di layout ereditano anche l'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da una presentazione diversa, le proprietà che ereditano dalle pagine principali o di layout vengono copiate sull'elemento dalla sorgente una presentazione.
// Copy a table between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var table = otherPresentationSlide.getTables[0]; currentPresentationSlide.insertTable(table); // Also available for Layout, Master, and Page.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
table | Table | La tabella da copiare e inserire. |
Invio
Table
: la tabella inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTextBox(text)
Inserisce nella pagina una casella di testo Shape
contenente la stringa fornita.
La forma della casella di testo viene inserita con una dimensione predefinita nell'angolo in alto a sinistra della pagina.
// Insert text box with "Hello" on the first slide of presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | La stringa che deve essere contenuta nella forma della casella di testo. |
Invio
Shape
: la forma della casella di testo inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTextBox(text, left, top, width, height)
Inserisce nella pagina una casella di testo Shape
contenente la stringa fornita.
// Insert text box with "Hello" on the first slide of presentation. This text box is a square // with a length of 10 points on each side. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | La stringa che deve essere contenuta nella forma della casella di testo. |
left | Number | La posizione orizzontale della forma della casella di testo, misurata dall'angolo in alto a sinistra. della pagina. |
top | Number | La posizione verticale della forma della casella di testo, misurata dall'angolo in alto a sinistra della della pagina. |
width | Number | La larghezza della forma della casella di testo. |
height | Number | L'altezza della forma della casella di testo. |
Invio
Shape
: la forma della casella di testo inserita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl)
Inserisce un video nell'angolo in alto a sinistra della pagina con una dimensione predefinita.
Al momento sono supportati solo i video di YouTube.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
videoUrl | String | L'URL del video da inserire. |
Invio
Video
- Il video inserito.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl, left, top, width, height)
Inserisce nella pagina un video con la posizione e le dimensioni specificate.
Al momento sono supportati solo i video di YouTube.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
videoUrl | String | L'URL del video da inserire. |
left | Number | La posizione orizzontale del video in punti, misurata dall'angolo in alto a sinistra. della pagina. |
top | Number | La posizione verticale del video in punti, misurata dall'angolo in alto a sinistra di della pagina. |
width | Number | La larghezza del video in punti. |
height | Number | L'altezza del video in punti. |
Invio
Video
- Il video inserito.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(video)
Inserisce nella pagina una copia del valore Video
fornito.
La posizione dell'elemento inserito in questa pagina è determinata dalla posizione nella rispettiva pagina.
Se l'elemento fornito è un segnaposto che viene copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine principali o di layout ereditano anche l'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da una presentazione diversa, le proprietà che ereditano dalle pagine principali o di layout vengono copiate sull'elemento dalla sorgente una presentazione.
// Copy a video between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var video = otherPresentationSlide.getVideos[0]; currentPresentationSlide.insertVideo(video); // Also available for Layout, Master, and Page.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
video | Video | Il video da copiare e inserire. |
Invio
Video
- Il video inserito.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertWordArt(wordArt)
Inserisce nella pagina una copia del valore WordArt
fornito.
La posizione dell'elemento inserito in questa pagina è determinata dalla posizione nella rispettiva pagina.
Se l'elemento fornito è un segnaposto che viene copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine principali o di layout ereditano anche l'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da una presentazione diversa, le proprietà che ereditano dalle pagine principali o di layout vengono copiate sull'elemento dalla sorgente una presentazione.
// Copy a word art between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
wordArt | WordArt | Il gruppo da copiare e inserire. |
Invio
WordArt
: il WordArt inserito.
Autorizzazione
Gli script che utilizzano questo 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 la 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
replaceAllText(findText, replaceText)
Sostituisce tutte le istanze di testo corrispondenti a Trova testo con Sostituisci testo. La ricerca è maiuscola insensibile.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
findText | String | Il testo da trovare. |
replaceText | String | Il testo per sostituire il testo corrispondente. |
Invio
Integer
: il numero di occorrenze modificato
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
Sostituisce tutte le istanze di testo corrispondenti a Trova testo con Sostituisci testo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
findText | String | Il testo da trovare. |
replaceText | String | Il testo per sostituire il testo corrispondente. |
matchCase | Boolean | Se true , la ricerca è sensibile alle maiuscole. se false , la ricerca viene
senza distinzione tra maiuscole e minuscole. |
Invio
Integer
: il numero di occorrenze modificato
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
selectAsCurrentPage()
Seleziona Page
nella presentazione attiva come current page selection
e rimuove la selezione precedente.
Uno script può accedere solo alla selezione dell'utente che lo esegue e solo se lo script è legato alla presentazione.
// Select the first slide as the current page selection and replace any previous selection. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations