Un layout in una presentazione.
Ogni layout funge da modello per le slide che ne derivano, determinando l'organizzazione e lo stile dei contenuti delle diapositive.
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
getBackground() | PageBackground | Consente di acquisire lo sfondo della pagina. |
getColorScheme() | ColorScheme | Consente di ottenere 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 | Restituisce il nome del layout. |
getLines() | Line[] | Restituisce l'elenco di Line oggetti nella pagina. |
getMaster() | Master | Consente di acquisire lo schema su cui si basa il layout. |
getObjectId() | String | Consente di acquisire l'ID univoco della pagina. |
getPageElementById(id) | PageElement | Restituisce PageElement nella pagina con l'ID specificato oppure null se non ne esiste nessuno. |
getPageElements() | PageElement[] | Restituisce l'elenco di PageElement oggetti di cui è stato eseguito il rendering nella pagina. |
getPageType() | PageType | Restituisce il tipo di pagina. |
getPlaceholder(placeholderType) | PageElement | Restituisce l'oggetto segnaposto PageElement per un valore PlaceholderType o null specificato se non è presente un segnaposto corrispondente. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | Restituisce l'oggetto segnaposto PageElement per un valore PlaceholderType specificato e un indice segnaposto oppure null se il segnaposto non è presente. |
getPlaceholders() | PageElement[] | Restituisce l'elenco degli 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 di pagina specificati. |
insertGroup(group) | Group | Inserisce una copia del Group fornito nella pagina. |
insertImage(blobSource) | Image | Inserisce un'immagine nell'angolo in alto a sinistra della pagina con una dimensione predefinita dal blob di immagine specificato. |
insertImage(blobSource, left, top, width, height) | Image | Inserisce nella pagina un'immagine con la posizione e le dimensioni fornite dal blob di immagine specificato. |
insertImage(image) | Image | Inserisce una copia del Image fornito nella pagina. |
insertImage(imageUrl) | Image | Inserisce un'immagine nell'angolo in alto a sinistra della pagina con una dimensione predefinita dall'URL fornito. |
insertImage(imageUrl, left, top, width, height) | Image | Inserisce un'immagine nella pagina con la posizione e le dimensioni fornite dall'URL fornito. |
insertLine(line) | Line | Inserisce una copia del Line fornito nella pagina. |
insertLine(lineCategory, startConnectionSite, endConnectionSite) | Line | Inserisce una riga sulla pagina che collega due connection sites. |
insertLine(lineCategory, startLeft, startTop, endLeft, endTop) | Line | Inserisce una linea nella pagina. |
insertPageElement(pageElement) | PageElement | Inserisce una copia del PageElement fornito nella pagina. |
insertShape(shape) | Shape | Inserisce una copia del Shape fornito nella pagina. |
insertShape(shapeType) | Shape | Inserisce una forma nella pagina. |
insertShape(shapeType, left, top, width, height) | Shape | Inserisce una forma nella pagina. |
insertSheetsChart(sourceChart) | SheetsChart | Inserisce un grafico di Fogli Google nella pagina. |
insertSheetsChart(sourceChart, left, top, width, height) | SheetsChart | Inserisce un grafico di Fogli Google nella pagina con la posizione e le dimensioni fornite. |
insertSheetsChart(sheetsChart) | SheetsChart | Inserisce una copia del SheetsChart fornito nella pagina. |
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 le dimensioni fornite. |
insertTable(numRows, numColumns) | Table | Inserisce una tabella nella pagina. |
insertTable(numRows, numColumns, left, top, width, height) | Table | Inserisce una tabella nella pagina con la posizione e le dimensioni fornite. |
insertTable(table) | Table | Inserisce una copia del Table fornito nella pagina. |
insertTextBox(text) | Shape | Inserisce una casella di testo Shape contenente la stringa fornita nella pagina. |
insertTextBox(text, left, top, width, height) | Shape | Inserisce una casella di testo Shape contenente la stringa fornita nella pagina. |
insertVideo(videoUrl) | Video | Inserisce un video con dimensioni predefinite nell'angolo in alto a sinistra della pagina. |
insertVideo(videoUrl, left, top, width, height) | Video | Inserisce un video nella pagina con la posizione e le dimensioni fornite. |
insertVideo(video) | Video | Inserisce una copia del Video fornito nella pagina. |
insertWordArt(wordArt) | WordArt | Inserisce una copia del WordArt fornito nella pagina. |
remove() | void | Rimuove la pagina. |
replaceAllText(findText, replaceText) | Integer | Sostituisce tutte le istanze del testo che corrisponde al testo trovato con testo Sostituisci. |
replaceAllText(findText, replaceText, matchCase) | Integer | Sostituisce tutte le istanze del testo che corrisponde al testo trovato con testo Sostituisci. |
selectAsCurrentPage() | void | Seleziona il Page nella presentazione attiva come current page selection e rimuove qualsiasi selezione precedente. |
Documentazione dettagliata
getBackground()
Consente di acquisire lo sfondo della pagina.
Ritorni
PageBackground: 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
getColorScheme()
Consente di ottenere l'elemento ColorScheme associato alla pagina.
Ritorni
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()
Restituisce il nome del layout.
Ritorni
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()
Consente di acquisire l'ID univoco della pagina. Gli ID oggetto utilizzati da pagine ed elementi di pagina condividono lo stesso spazio dei nomi.
Ritorni
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 oppure null se non ne esiste nessuno.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id | String | L'ID dell'elemento di pagina recuperato. |
Ritorni
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 di cui è stato eseguito il rendering nella pagina.
Ritorni
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 o null specificato se non è presente un segnaposto corrispondente.
Se sono presenti più segnaposto dello stesso tipo, viene restituito quello con indice segnaposto minimo. Se sono presenti più segnaposto corrispondenti con lo stesso indice, viene restituito il primo segnaposto della raccolta di 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 |
Ritorni
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 valore PlaceholderType specificato e un indice segnaposto oppure null se il segnaposto non è presente.
Se sono presenti più segnaposto con lo stesso tipo e indice, viene restituito il primo segnaposto della raccolta di elementi di 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 |
Ritorni
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 degli oggetti segnaposto PageElement nella pagina.
var master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);
Ritorni
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.
Ritorni
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 di pagina specificati.
Sulla stessa pagina dovrebbero esserci almeno due elementi che non sono già in un altro gruppo. Alcuni elementi di pagina, come Videos, Tables e placeholder Shapes, non possono essere raggruppati.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
pageElements | PageElement[] | Gli elementi da raggruppare. |
Ritorni
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 una copia del Group fornito nella pagina.
La posizione dell'elemento inserito in questa pagina dipende dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dall'interno della presentazione corrente, anche 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 nell'elemento dalla presentazione di origine.
// 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. |
Ritorni
Group: 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 in alto a sinistra della pagina con una dimensione predefinita dal blob di immagine specificato.
Se inserisci l'immagine, questa viene recuperata da BlobSource una volta 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.
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. |
Ritorni
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 fornite dal blob di immagine specificato.
L'immagine viene recuperata dall'elemento BlobSource fornito una volta al momento dell'inserimento e una copia viene archiviata per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
Per mantenere le proporzioni dell'immagine, questa viene ridimensionata e centrata rispetto alle dimensioni fornite.
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 della pagina. |
width | Number | La larghezza dell'immagine in punti. |
height | Number | L'altezza dell'immagine in punti. |
Ritorni
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 una copia del Image fornito nella pagina.
La posizione delle immagini inserite in questa pagina dipende dalla posizione dell'immagine di origine nella rispettiva pagina.
Se l'immagine fornita è un segnaposto che viene copiato dall'interno della presentazione corrente, anche le proprietà che ereditano 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 master o di layout vengono copiate nell'immagine dalla presentazione di origine. Se l'immagine segnaposto copiata è vuota, nella presentazione di destinazione non viene inserito nulla.
// 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. |
Ritorni
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 un'immagine nell'angolo in alto a sinistra della pagina con una dimensione predefinita dall'URL fornito.
Se inserisci l'immagine, questa viene recuperata dall'URL una volta 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.
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. |
Ritorni
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 un'immagine nella pagina con la posizione e le dimensioni fornite dall'URL fornito.
Se inserisci l'immagine, questa viene recuperata dall'URL una volta 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.
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 dell'immagine, questa viene ridimensionata e centrata rispetto alle dimensioni fornite.
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 della pagina. |
width | Number | La larghezza dell'immagine in punti. |
height | Number | L'altezza dell'immagine in punti. |
Ritorni
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 una copia del Line fornito nella pagina.
La posizione dell'elemento inserito in questa pagina dipende dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dall'interno della presentazione corrente, anche 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 nell'elemento dalla presentazione di origine.
// 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. |
Ritorni
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 una riga sulla 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.
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 connesso l'inizio della linea. |
endConnectionSite | ConnectionSite | Il sito di connessione a cui deve essere collegata la fine della linea. |
Ritorni
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 linea 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 dall'angolo in alto a sinistra della pagina. |
endLeft | Number | La posizione orizzontale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
endTop | Number | La posizione verticale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
Ritorni
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 una copia del PageElement fornito nella pagina.
La posizione dell'elemento inserito in questa pagina dipende dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dall'interno della presentazione corrente, anche 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 nell'elemento dalla presentazione di origine.
// 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. |
Ritorni
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 una copia del Shape fornito nella pagina.
La posizione dell'elemento inserito in questa pagina dipende dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dall'interno della presentazione corrente, anche 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 nell'elemento dalla presentazione di origine.
// 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. |
Ritorni
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 superiore sinistro 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. |
Ritorni
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 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. |
Ritorni
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 un grafico di Fogli Google nella pagina.
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 ne consente l'aggiornamento. 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. |
Ritorni
SheetsChart: 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 un grafico di Fogli Google nella pagina con la posizione e le dimensioni fornite.
Per mantenere le proporzioni, il grafico viene ridimensionato e centrato rispetto alle dimensioni fornite.
Il grafico inserito è collegato al grafico di origine di Fogli Google, che ne consente l'aggiornamento. 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 nell'angolo in alto a sinistra della pagina. |
width | Number | La larghezza del grafico in punti. |
height | Number | L'altezza del grafico in punti. |
Ritorni
SheetsChart: 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 una copia del SheetsChart fornito nella pagina.
La posizione dell'elemento inserito in questa pagina dipende dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dall'interno della presentazione corrente, anche 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 nell'elemento dalla presentazione di origine.
// 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 di fogli da copiare e inserire. |
Ritorni
SheetsChart: grafico dei fogli inseriti.
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 le dimensioni predefinite nell'angolo in alto a sinistra della pagina.
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];
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. |
Ritorni
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 le dimensioni fornite.
Per mantenere le proporzioni dell'immagine del grafico, questa viene ridimensionata e centrata 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 nell'angolo in alto a sinistra della pagina. |
width | Number | La larghezza del grafico in punti. |
height | Number | L'altezza del grafico in punti. |
Ritorni
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 in modo uniforme.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
numRows | Integer | Il numero di righe nella tabella. |
numColumns | Integer | Il numero di colonne nella tabella. |
Ritorni
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 una tabella nella pagina con la posizione e le dimensioni fornite.
Le righe e le colonne sono 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 nell'angolo in alto a sinistra della pagina. |
top | Number | La posizione verticale della tabella, misurata nell'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 del carattere del testo. |
Ritorni
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 una copia del Table fornito nella pagina.
La posizione dell'elemento inserito in questa pagina dipende dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dall'interno della presentazione corrente, anche 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 nell'elemento dalla presentazione di origine.
// 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. |
Ritorni
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 una casella di testo Shape contenente la stringa fornita nella pagina.
La forma della casella di testo viene inserita con una dimensione predefinita nell'angolo superiore sinistro 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 contenere la forma della casella di testo. |
Ritorni
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 una casella di testo Shape contenente la stringa fornita nella pagina.
// 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 contenere la 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 pagina. |
width | Number | La larghezza della forma della casella di testo. |
height | Number | L'altezza della forma della casella di testo. |
Ritorni
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 con dimensioni predefinite nell'angolo in alto a sinistra della pagina.
Al momento sono supportati solo i video di YouTube.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
videoUrl | String | L'URL del video da inserire. |
Ritorni
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 un video nella pagina con la posizione e le dimensioni fornite.
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 della pagina. |
width | Number | La larghezza del video in punti. |
height | Number | L'altezza del video in punti. |
Ritorni
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 una copia del Video fornito nella pagina.
La posizione dell'elemento inserito in questa pagina dipende dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dall'interno della presentazione corrente, anche 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 nell'elemento dalla presentazione di origine.
// 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. |
Ritorni
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 una copia del WordArt fornito nella pagina.
La posizione dell'elemento inserito in questa pagina dipende dalla posizione dell'elemento di origine nella rispettiva pagina.
Se l'elemento fornito è un segnaposto copiato dall'interno della presentazione corrente, anche 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 nell'elemento dalla presentazione di origine.
// 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. |
Ritorni
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 del testo che corrisponde al testo trovato con testo Sostituisci. La ricerca non fa distinzione tra maiuscole e minuscole.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
findText | String | Il testo da trovare. |
replaceText | String | Il testo da sostituire al testo corrispondente. |
Ritorni
Integer: il numero di occorrenze è cambiato
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 del testo che corrisponde al testo trovato con testo Sostituisci.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
findText | String | Il testo da trovare. |
replaceText | String | Il testo da sostituire al testo corrispondente. |
matchCase | Boolean | Se true, la ricerca è sensibile alle maiuscole; in false, la ricerca non fa distinzione tra maiuscole e minuscole. |
Ritorni
Integer: il numero di occorrenze è cambiato
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 il Page nella presentazione attiva come current page selection e rimuove qualsiasi selezione precedente.
Uno script può accedere solo alla selezione dell'utente che lo esegue e solo se è associato 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