Un layout in una presentazione.
Ogni layout funge da modello per le diapositive che lo ereditano, determinando la disposizione e lo stile dei contenuti su queste diapositive.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
get | Page | Recupera lo sfondo della pagina. |
get | Color | Recupera il Color associato alla pagina. |
get | Group[] | Restituisce l'elenco degli oggetti Group nella pagina. |
get | Image[] | Restituisce l'elenco degli oggetti Image nella pagina. |
get | String | Restituisce il nome del layout. |
get | Line[] | Restituisce l'elenco degli oggetti Line nella pagina. |
get | Master | Recupera il master su cui si basa il layout. |
get | String | Recupera l'ID univoco della pagina. |
get | Page | Restituisce il Page nella pagina con l'ID specificato o null se non esiste. |
get | Page | Restituisce l'elenco degli oggetti Page visualizzati nella pagina. |
get | Page | Recupera il tipo di pagina. |
get | Page | Restituisce l'oggetto segnaposto Page per un Placeholder o
null specificato se non è presente un segnaposto corrispondente. |
get | Page | Restituisce l'oggetto segnaposto Page per un Placeholder e un indice segnaposto specificati oppure null se il segnaposto non è presente. |
get | Page | Restituisce l'elenco degli oggetti segnaposto Page nella pagina. |
get | Shape[] | Restituisce l'elenco degli oggetti Shape nella pagina. |
get | Sheets | Restituisce l'elenco degli oggetti Sheets nella pagina. |
get | Table[] | Restituisce l'elenco degli oggetti Table nella pagina. |
get | Video[] | Restituisce l'elenco degli oggetti Video nella pagina. |
get | Word | Restituisce l'elenco degli oggetti Word nella pagina. |
group(pageElements) | Group | Raggruppa tutti gli elementi della pagina specificati. |
insert | Group | Inserisce una copia del Group fornito nella pagina. |
insert | Image | Inserisce un'immagine nell'angolo in alto a sinistra della pagina con le dimensioni predefinite del blob immagine specificato. |
insert | Image | Inserisce un'immagine nella pagina con la posizione e le dimensioni fornite dal blob immagine specificato. |
insert | Image | Inserisce una copia del Image fornito nella pagina. |
insert | Image | Inserisce un'immagine nell'angolo in alto a sinistra della pagina con le dimensioni predefinite dell'URL fornito. |
insert | Image | Inserisce un'immagine nella pagina con la posizione e le dimensioni specificate dall'URL fornito. |
insert | Line | Inserisce una copia del Line fornito nella pagina. |
insert | Line | Inserisce una linea nella pagina che collega due connection sites . |
insert | Line | Inserisce una riga nella pagina. |
insert | Page | Inserisce una copia del Page fornito nella pagina. |
insert | Shape | Inserisce una copia del Shape fornito nella pagina. |
insert | Shape | Inserisce una forma nella pagina. |
insert | Shape | Inserisce una forma nella pagina. |
insert | Sheets | Inserisce un grafico di Fogli Google nella pagina. |
insert | Sheets | Inserisce un grafico di Fogli Google nella pagina con la posizione e le dimensioni specificate. |
insert | Sheets | Inserisce una copia del Sheets fornito nella pagina. |
insert | Image | Inserisce un grafico di Fogli Google come Image nella pagina. |
insert | Image | Inserisce un grafico di Fogli Google come Image nella pagina con le dimensioni e la posizione fornite. |
insert | Table | Inserisce una tabella nella pagina. |
insert | Table | Inserisce una tabella nella pagina con la posizione e le dimensioni specificate. |
insert | Table | Inserisce una copia del Table fornito nella pagina. |
insert | Shape | Inserisce nella pagina una casella di testo Shape contenente la stringa fornita. |
insert | Shape | Inserisce nella pagina una casella di testo Shape contenente la stringa fornita. |
insert | Video | Inserisce un video nell'angolo in alto a sinistra della pagina con dimensioni predefinite. |
insert | Video | Inserisce un video nella pagina con la posizione e le dimensioni specificate. |
insert | Video | Inserisce una copia del Video fornito nella pagina. |
insert | Word | Inserisce una copia del Word fornito nella pagina. |
remove() | void | Rimuove la pagina. |
replace | Integer | Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo. |
replace | Integer | Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo. |
select | void | Consente di selezionare il Page nella presentazione attiva come current page selection e di rimuovere qualsiasi selezione precedente. |
Documentazione dettagliata
get Background()
Recupera lo sfondo della pagina.
Invio
Page
: lo 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
get Color Scheme()
Recupera il Color
associato alla pagina.
Invio
Color
: 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
get Groups()
get Images()
get Layout Name()
Restituisce 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
get Lines()
get Master()
get Object Id()
Recupera l'ID univoco della pagina. Gli ID oggetto utilizzati dalle pagine e dagli elementi della pagina condividono lo stesso 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
get Page Element By Id(id)
Restituisce il Page
nella pagina con l'ID specificato o null
se non esiste.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
id | String | L'ID dell'elemento della pagina che viene recuperato. |
Invio
Page
: l'elemento della 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
get Page Elements()
Restituisce l'elenco degli oggetti Page
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
get Page Type()
get Placeholder(placeholderType)
Restituisce l'oggetto segnaposto Page
per un Placeholder
o
null
specificato se non è presente un segnaposto corrispondente.
Se sono presenti più segnaposto dello stesso tipo, viene restituito quello con l'indice del segnaposto minimo. Se sono presenti più segnaposto corrispondenti con lo stesso indice, viene restituito il primo segnaposto dalla raccolta degli elementi della pagina.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, );
Parametri
Nome | Tipo | Descrizione |
---|---|---|
placeholder | Placeholder |
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
get Placeholder(placeholderType, placeholderIndex)
Restituisce l'oggetto segnaposto Page
per un Placeholder
e un indice segnaposto specificati oppure null
se il segnaposto non è presente.
Se sono presenti più segnaposto con lo stesso tipo e indice, viene restituito il primo segnaposto dalla raccolta degli elementi della pagina.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, 0, );
Parametri
Nome | Tipo | Descrizione |
---|---|---|
placeholder | Placeholder | |
placeholder | 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
get Placeholders()
Restituisce l'elenco degli oggetti segnaposto Page
nella pagina.
const 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
get Shapes()
get Sheets Charts()
Restituisce l'elenco degli oggetti Sheets
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
get Tables()
get Videos()
get Word Arts()
group(pageElements)
Raggruppa tutti gli elementi della pagina specificati.
Nella stessa pagina devono essere presenti almeno due elementi che non sono già in un altro gruppo. Alcuni elementi della pagina, come Videos
, Tables
e placeholder Shapes
, non possono essere raggruppati.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
page | Page | 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
insert Group(group)
Inserisce una copia del Group
fornito nella pagina.
La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.
// Copy a group between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const 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
insert Image(blobSource)
Inserisce un'immagine nell'angolo in alto a sinistra della pagina con le dimensioni predefinite del blob immagine specificato.
L'inserimento dell'immagine la recupera una volta da Blob
e ne viene archiviata una copia per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); slide.insertImage(image);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blob | Blob | I dati 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
insert Image(blobSource, left, top, width, height)
Inserisce un'immagine nella pagina con la posizione e le dimensioni fornite dal blob immagine specificato.
L'immagine viene recuperata dal Blob
fornito una volta al momento dell'inserimento e una copia viene archiviata per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
Per mantenere le proporzioni dell'immagine, questa viene ridimensionata e centrata rispetto alle dimensioni fornite.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); const position = { left: 0, top: 0 }; const size = { width: 300, height: 100 }; slide.insertImage(image, position.left, position.top, size.width, size.height);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blob | Blob | I dati 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 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
insert Image(image)
Inserisce una copia del Image
fornito nella pagina.
La posizione delle immagini inserite in questa pagina viene determinata dalla posizione dell'immagine di origine sulla rispettiva pagina.
Se l'immagine fornita è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche dall'immagine inserita.
Se l'immagine fornita è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate sull'immagine dalla presentazione di origine. Se l'immagine segnaposto copiata è vuota, nella presentazione di destinazione non viene inserito nulla.
// Copy an image between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const 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
insert Image(imageUrl)
Inserisce un'immagine nell'angolo in alto a sinistra della pagina con le dimensioni predefinite dell'URL fornito.
L'inserimento dell'immagine la recupera dall'URL una volta e ne viene memorizzata una copia per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
L'URL fornito deve essere pubblicamente accessibile e non deve superare i 2 kB. L'URL stesso viene salvato con l'immagine ed esposto tramite Image.getSourceUrl()
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
image | 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
insert Image(imageUrl, left, top, width, height)
Inserisce un'immagine nella pagina con la posizione e le dimensioni specificate dall'URL fornito.
L'inserimento dell'immagine la recupera dall'URL una volta e ne viene memorizzata una copia per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
L'URL fornito deve essere pubblicamente accessibile e non deve superare i 2 kB. L'URL stesso viene salvato con l'immagine ed esposto tramite Image.getSourceUrl()
.
Per mantenere le proporzioni dell'immagine, questa viene ridimensionata e centrata rispetto alle dimensioni fornite.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
image | 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 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
insert Line(line)
Inserisce una copia del Line
fornito nella pagina.
La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.
// Copy a line between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const 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
insert Line(lineCategory, startConnectionSite, endConnectionSite)
Inserisce una linea nella pagina che collega due connection sites
. I due siti di collegamento devono trovarsi in questa pagina.
// Insert a line in the first slide of the presentation connecting two shapes. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1], );
Parametri
Nome | Tipo | Descrizione |
---|---|---|
line | Line | La categoria della riga da inserire. |
start | Connection | Il sito di collegamento in cui deve essere collegata l'inizio della linea. |
end | Connection | 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
insert Line(lineCategory, startLeft, startTop, endLeft, endTop)
Inserisce una riga nella pagina.
// Insert a line in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const startPoint = { left: 10, top: 10 }; const endPoint = { left: 40, top: 40 }; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top, );
Parametri
Nome | Tipo | Descrizione |
---|---|---|
line | Line | La categoria della riga da inserire. |
start | Number | La posizione orizzontale del punto di inizio della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
start | Number | La posizione verticale del punto di inizio della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
end | Number | La posizione orizzontale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
end | Number | La posizione verticale del punto finale della linea, misurata in punti dall'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
insert Page Element(pageElement)
Inserisce una copia del Page
fornito nella pagina.
La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.
// Copy a page element between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
page | Page | L'elemento della pagina da copiare e inserire. |
Invio
Page
: 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
insert Shape(shape)
Inserisce una copia del Shape
fornito nella pagina.
La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.
// Copy a shape between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const 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
insert Shape(shapeType)
Inserisce una forma nella pagina.
La forma viene inserita con dimensioni predefinite nell'angolo in alto a sinistra della pagina.
// Insert a shape in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
shape | Shape | 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
insert Shape(shapeType, left, top, width, height)
Inserisce una forma nella pagina.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
shape | Shape | Il tipo di forma da inserire. |
left | Number | La posizione orizzontale della forma, misurata dall'angolo in alto a sinistra della pagina. |
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
insert Sheets Chart(sourceChart)
Inserisce un grafico di Fogli Google nella pagina.
Il grafico viene inserito con dimensioni predefinite nell'angolo in alto a sinistra della pagina.
Il grafico inserito è collegato al grafico di Fogli Google di origine, il che consente di aggiornarlo. Gli altri collaboratori possono vedere il link al foglio di lavoro di origine.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
source | Embedded | Il grafico in un foglio di lavoro da inserire nella pagina. |
Invio
Sheets
: 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
insert Sheets Chart(sourceChart, left, top, width, height)
Inserisce un grafico di Fogli Google nella pagina con la posizione e le dimensioni specificate.
Per mantenere le proporzioni del grafico, il grafico viene ridimensionato e centrato rispetto alle dimensioni fornite.
Il grafico inserito è collegato al grafico di Fogli Google di origine, il che consente di aggiornarlo. Gli altri collaboratori possono vedere il link al foglio di lavoro di origine.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const 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 |
---|---|---|
source | Embedded | 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 della pagina. |
width | Number | La larghezza del grafico in punti. |
height | Number | L'altezza del grafico in punti. |
Invio
Sheets
: 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
insert Sheets Chart(sheetsChart)
Inserisce una copia del Sheets
fornito nella pagina.
La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.
// Copy a sheets chart between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sheets | Sheets | Il grafico di Fogli da copiare e inserire. |
Invio
Sheets
: 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
insert Sheets Chart As Image(sourceChart)
Inserisce un grafico di Fogli Google come Image
nella pagina.
L'immagine del grafico viene inserita con dimensioni predefinite nell'angolo in alto a sinistra della pagina.
L'immagine del grafico inserita non è collegata al grafico di Fogli Google di origine.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage( chart); // Also available for Layout, Master, and Page.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
source | Embedded | Il grafico in un foglio di lavoro da inserire nella pagina. |
Invio
Image
: l'immagine del grafico inserita 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
insert Sheets Chart As Image(sourceChart, left, top, width, height)
Inserisce un grafico di Fogli Google come Image
nella pagina con la posizione e le dimensioni fornite.
Per mantenere le proporzioni dell'immagine del grafico, l'immagine viene ridimensionata e centrata rispetto alle dimensioni fornite.
L'immagine del grafico inserita non è collegata al grafico di Fogli Google di origine.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const 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 |
---|---|---|
source | Embedded | 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 della pagina. |
width | Number | La larghezza del grafico in punti. |
height | Number | L'altezza del grafico in punti. |
Invio
Image
: l'immagine del grafico inserita 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
insert Table(numRows, numColumns)
Inserisce una tabella nella pagina.
La tabella è centrata nella pagina con dimensioni predefinite e righe e colonne distribuite uniformemente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
num | Integer | Il numero di righe nella tabella. |
num | 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
insert Table(numRows, numColumns, left, top, width, height)
Inserisce una tabella nella pagina con la posizione e le dimensioni specificate.
Le righe e le colonne sono distribuite uniformemente nella tabella creata.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
num | Integer | Il numero di righe nella tabella. |
num | Integer | Il numero di colonne nella tabella. |
left | Number | La posizione orizzontale della tabella, misurata dall'angolo in alto a sinistra della pagina. |
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 da fattori quali le dimensioni dei caratteri del testo. |
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
insert Table(table)
Inserisce una copia del Table
fornito nella pagina.
La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.
// Copy a table between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const 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
insert Text Box(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. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | La stringa che la forma della casella di testo deve contenere. |
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
insert Text Box(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. const 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 la forma della casella di testo deve contenere. |
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 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
insert Video(videoUrl)
Inserisce un video nell'angolo in alto a sinistra della pagina con dimensioni predefinite.
Al momento sono supportati solo i video di YouTube.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
video | 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
insert Video(videoUrl, left, top, width, height)
Inserisce un video nella pagina con la posizione e le dimensioni specificate.
Al momento sono supportati solo i video di YouTube.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
video | 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 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
insert Video(video)
Inserisce una copia del Video
fornito nella pagina.
La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.
// Copy a video between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const 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
insert Word Art(wordArt)
Inserisce una copia del Word
fornito nella pagina.
La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.
Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.
// Copy a word art between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
word | Word | Il gruppo da copiare e inserire. |
Invio
Word
: la parola in WordArt 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
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
replace All Text(findText, replaceText)
Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo. La ricerca non fa distinzione tra maiuscole e minuscole.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
find | String | Il testo da trovare. |
replace | String | Il testo da sostituire al testo corrispondente. |
Invio
Integer
: il numero di occorrenze modificate
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText, matchCase)
Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
find | String | Il testo da trovare. |
replace | String | Il testo da sostituire al testo corrispondente. |
match | Boolean | Se true , la ricerca è sensibile alle maiuscole; se false , la ricerca è
insensibile alle maiuscole. |
Invio
Integer
: il numero di occorrenze modificate
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 As Current Page()
Consente di selezionare il Page
nella presentazione attiva come current page selection
e di rimuovere qualsiasi selezione precedente.
Uno script può accedere alla selezione dell'utente che lo esegue solo se è legato alla presentazione.
// Select the first slide as the current page selection and replace any previous // selection. const 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