Układ w prezentacji.
Każdy układ służy jako szablon dla slajdów, które go dziedziczą, określając sposób rozmieszczenia i stylizowania treści na tych slajdach.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
get | Page | Pobiera tło strony. |
get | Color | Pobiera Color powiązany ze stroną. |
get | Group[] | Zwraca listę obiektów Group na stronie. |
get | Image[] | Zwraca listę obiektów Image na stronie. |
get | String | Pobiera nazwę układu. |
get | Line[] | Zwraca listę obiektów Line na stronie. |
get | Master | Pobiera element główny, na którym jest oparty układ. |
get | String | Pobiera unikalny identyfikator strony. |
get | Page | Zwraca Page na stronie o podanym identyfikatorze lub null , jeśli żadna nie istnieje. |
get | Page | Zwraca listę obiektów Page wyrenderowanych na stronie. |
get | Page | Pobiera typ strony. |
get | Page | Zwraca obiekt zastępnik Page dla określonego elementu Placeholder lub null , jeśli nie ma pasującego elementu zastępczego. |
get | Page | Zwraca obiekt zastępnik Page dla określonego Placeholder i indeksu zastępnika lub null , jeśli zastępnik jest nieobecny. |
get | Page | Zwraca listę obiektów zastępczych Page na stronie. |
get | Shape[] | Zwraca listę obiektów Shape na stronie. |
get | Sheets | Zwraca listę obiektów Sheets na stronie. |
get | Table[] | Zwraca listę obiektów Table na stronie. |
get | Video[] | Zwraca listę obiektów Video na stronie. |
get | Word | Zwraca listę obiektów Word na stronie. |
group(pageElements) | Group | Grupuje wszystkie określone elementy strony. |
insert | Group | Wstawia na stronie kopię podanego elementu Group . |
insert | Image | Wstawia obraz w lewym górnym rogu strony w domyślnym rozmiarze z określonego pliku blob obrazu. |
insert | Image | Wstawia na stronie obraz z określonego obiektu blob obrazu o podanej pozycji i rozmiarze. |
insert | Image | Wstawia na stronie kopię podanego elementu Image . |
insert | Image | Wstawia obraz w lewym górnym rogu strony w domyślnym rozmiarze z podanego adresu URL. |
insert | Image | Wstawia obraz na stronie w określonej pozycji i rozmiarze z podanego adresu URL. |
insert | Line | Wstawia na stronie kopię podanego elementu Line . |
insert | Line | Wstawia na stronie linię łączącą 2 connection sites . |
insert | Line | Wstawia linię na stronie. |
insert | Page | Wstawia na stronie kopię podanego elementu Page . |
insert | Shape | Wstawia na stronie kopię podanego elementu Shape . |
insert | Shape | Wstawia kształt na stronie. |
insert | Shape | Wstawia kształt na stronie. |
insert | Sheets | Wstawia na stronie wykres z Arkuszy Google. |
insert | Sheets | Wstawia wykres arkuszy Google na stronie w podanym położeniu i rozmiarze. |
insert | Sheets | Wstawia na stronie kopię podanego elementu Sheets . |
insert | Image | Wstawia wykres z Arkuszy Google jako Image na stronie. |
insert | Image | Wstawia wykres z Arkuszy Google jako element Image na stronie w wybranej pozycji i rozmiarze. |
insert | Table | Wstawia tabelę na stronie. |
insert | Table | Wstawia tabelę na stronie w podanym położeniu i rozmiarze. |
insert | Table | Wstawia na stronie kopię podanego elementu Table . |
insert | Shape | Wstawia na stronie pole tekstowe Shape zawierające podany ciąg znaków. |
insert | Shape | Wstawia na stronie pole tekstowe Shape zawierające podany ciąg znaków. |
insert | Video | Wstawia film w lewym górnym rogu strony w domyślnym rozmiarze. |
insert | Video | Wstawia film na stronie w określonej pozycji i rozmiarze. |
insert | Video | Wstawia na stronie kopię podanego elementu Video . |
insert | Word | Wstawia na stronie kopię podanego elementu Word . |
remove() | void | Usuwa stronę. |
replace | Integer | Zastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia. |
replace | Integer | Zastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia. |
select | void | Wybiera Page w aktywnej prezentacji jako current page selection i usuwa poprzednią selekcję. |
Szczegółowa dokumentacja
get Background()
Pobiera tło strony.
Powrót
Page
– tło strony.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Color Scheme()
Pobiera Color
powiązany ze stroną.
Powrót
Color
– schemat kolorów strony.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Groups()
get Images()
get Layout Name()
Pobiera nazwę układu.
Powrót
String
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Lines()
get Master()
get Object Id()
Pobiera unikalny identyfikator strony. Identyfikatory obiektów używane przez strony i elementy stron mają ten sam przedrostek.
Powrót
String
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Element By Id(id)
Zwraca Page
na stronie o podanym identyfikatorze lub null
, jeśli żadna nie istnieje.
Parametry
Nazwa | Typ | Opis |
---|---|---|
id | String | Identyfikator elementu strony, który jest pobierany. |
Powrót
Page
– element strony o danym identyfikatorze.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Elements()
Zwraca listę obiektów Page
wyrenderowanych na stronie.
Powrót
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Type()
get Placeholder(placeholderType)
Zwraca obiekt zastępnik Page
dla określonego elementu Placeholder
lub null
, jeśli nie ma pasującego elementu zastępczego.
Jeśli jest kilka zmiennych tego samego typu, zwraca zmienną o najmniejszym indeksie. Jeśli istnieje kilka pasujących zastępników o tym samym indeksie, zwraca pierwszy zastępnik z kolekcji elementów strony.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, );
Parametry
Nazwa | Typ | Opis |
---|---|---|
placeholder | Placeholder |
Powrót
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder(placeholderType, placeholderIndex)
Zwraca obiekt zastępnik Page
dla określonego Placeholder
i indeksu zastępnika lub null
, jeśli zastępnik jest nieobecny.
Jeśli istnieje kilka zapełniaczy o tym samym typie i tym samym indeksie, zwraca pierwszy zapełniacz z kolekcji elementów strony.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, 0, );
Parametry
Nazwa | Typ | Opis |
---|---|---|
placeholder | Placeholder | |
placeholder | Integer |
Powrót
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholders()
Zwraca listę obiektów zastępczych Page
na stronie.
const master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log( `Number of placeholders in the master: ${master.getPlaceholders().length}`, );
Powrót
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Shapes()
get Sheets Charts()
Zwraca listę obiektów Sheets
na stronie.
Powrót
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Tables()
get Videos()
get Word Arts()
group(pageElements)
Grupuje wszystkie określone elementy strony.
Na tej samej stronie musi znajdować się co najmniej 2 elementy, które nie należą do żadnej innej grupy. Niektórych elementów strony, takich jak Videos
, Tables
i placeholder Shapes
, nie można grupować.
Parametry
Nazwa | Typ | Opis |
---|---|---|
page | Page | Elementy, które mają być zgrupowane. |
Powrót
Group
– nowa grupa.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Group(group)
Wstawia na stronie kopię podanego elementu Group
.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z bieżącej prezentacji, właściwości dziedziczone z mastera lub stron układu są również dziedziczone przez wstawiany element.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z innej prezentacji, właściwości dziedziczone z głównej strony lub stron układu są kopiowane do elementu z prezentacji źródłowej.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
group | Group | Grupa, która ma zostać skopiowana i wstawiona. |
Powrót
Group
– wstawiona grupa.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(blobSource)
Wstawia obraz w lewym górnym rogu strony w domyślnym rozmiarze z określonego pliku blob obrazu.
Wstawianie obrazu powoduje jego pobranie z Blob
, a kopia jest przechowywana na potrzeby wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą mieć więcej niż 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); slide.insertImage(image);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | Blob | Dane obrazu. |
Powrót
Image
– wstawiony obraz.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(blobSource, left, top, width, height)
Wstawia na stronie obraz z określonego obiektu blob obrazu o podanej pozycji i rozmiarze.
Obraz jest pobierany z podanego adresu Blob
raz w momencie wstawienia, a jego kopia jest przechowywana na potrzeby wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.
Aby zachować format obrazu, obraz jest skalowany i wyśrodkowywany zgodnie z podanym rozmiarem.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | Blob | Dane obrazu. |
left | Number | Pozycja pozioma obrazu w punktach, mierzona od lewego górnego rogu strony. |
top | Number | Pozycja pionowa obrazu w punktach, mierzona od lewego górnego rogu strony. |
width | Number | Szerokość obrazu w punktach. |
height | Number | Wysokość obrazu w punktach. |
Powrót
Image
– wstawiony obraz.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(image)
Wstawia na stronie kopię podanego elementu Image
.
Położenie wstawionych obrazów na tej stronie jest określane na podstawie położenia obrazu źródłowego na odpowiedniej stronie.
Jeśli podany obraz jest elementem zastępczym kopiowanym z bieżącej prezentacji, właściwości dziedziczone z stron głównych lub stron układu są również dziedziczone przez wstawiony obraz.
Jeśli przesłany obraz jest miejscem substytucyjnym skopiowanym z innej prezentacji, właściwości dziedziczone z głównej strony lub strony układu są kopiowane na obraz z prezentacji źródłowej. Jeśli skopiowany obraz zastępczy jest pusty, w prezentacji docelowej nie zostanie wstawiony żaden element.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
image | Image | Obraz, który ma zostać skopiowany i wstawiony. |
Powrót
Image
– wstawiony obraz.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(imageUrl)
Wstawia obraz w lewym górnym rogu strony w domyślnym rozmiarze z podanego adresu URL.
Wstawianie obrazu powoduje jego pobieranie z adresu URL, a kopia jest przechowywana na potrzeby wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.
Podany adres URL musi być dostępny publicznie i nie może mieć rozmiaru większego niż 2 KB. Sam adres URL jest zapisywany wraz z obrazem i wyświetlany za pomocą Image.getSourceUrl()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
image | String | Adres URL obrazu. |
Powrót
Image
– wstawiony obraz.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(imageUrl, left, top, width, height)
Wstawia obraz na stronie w określonej pozycji i rozmiarze z podanego adresu URL.
Wstawianie obrazu powoduje jego pobieranie z adresu URL, a kopia jest przechowywana na potrzeby wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.
Podany adres URL musi być dostępny publicznie i nie może mieć rozmiaru większego niż 2 KB. Sam adres URL jest zapisywany wraz z obrazem i wyświetlany za pomocą Image.getSourceUrl()
.
Aby zachować format obrazu, obraz jest skalowany i wyśrodkowywany zgodnie z podanym rozmiarem.
Parametry
Nazwa | Typ | Opis |
---|---|---|
image | String | Adres URL obrazu. |
left | Number | Pozycja pozioma obrazu w punktach, mierzona od lewego górnego rogu strony. |
top | Number | Pozycja pionowa obrazu w punktach, mierzona od lewego górnego rogu strony. |
width | Number | Szerokość obrazu w punktach. |
height | Number | Wysokość obrazu w punktach. |
Powrót
Image
– wstawiony obraz.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(line)
Wstawia na stronie kopię podanego elementu Line
.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z bieżącej prezentacji, właściwości dziedziczone z mastera lub stron układu są również dziedziczone przez wstawiany element.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z innej prezentacji, właściwości dziedziczone z głównej strony lub stron układu są kopiowane do elementu z prezentacji źródłowej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
line | Line | wiersz do skopiowania i wklejenia. |
Powrót
Line
– wstawiony wiersz.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(lineCategory, startConnectionSite, endConnectionSite)
Wstawia na stronie linię łączącą 2 connection sites
. Na tej stronie muszą znajdować się 2 strony połączenia.
// 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], );
Parametry
Nazwa | Typ | Opis |
---|---|---|
line | Line | Kategoria linii do wstawienia. |
start | Connection | Miejsce połączenia, w którym ma być połączony początek linii. |
end | Connection | Miejsce połączenia, w którym ma nastąpić połączenie końca linii. |
Powrót
Line
– wstawiony wiersz.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(lineCategory, startLeft, startTop, endLeft, endTop)
Wstawia linię na stronie.
// 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, );
Parametry
Nazwa | Typ | Opis |
---|---|---|
line | Line | Kategoria linii do wstawienia. |
start | Number | Pozycja pozioma punktu początkowego linii, mierzona w punktach od lewego górnego rogu strony. |
start | Number | Pozycja pionowa punktu początkowego linii, mierzona w punktach od lewego górnego rogu strony. |
end | Number | Pozycja pozioma punktu końcowego linii, mierzona w punktach od lewego górnego rogu strony. |
end | Number | Pozycja pionowa punktu końcowego linii, mierzona w punktach od lewego górnego rogu strony. |
Powrót
Line
– wstawiony wiersz.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Page Element(pageElement)
Wstawia na stronie kopię podanego elementu Page
.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z bieżącej prezentacji, właściwości dziedziczone z mastera lub stron układu są również dziedziczone przez wstawiany element.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z innej prezentacji, właściwości dziedziczone z głównej strony lub stron układu są kopiowane do elementu z prezentacji źródłowej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
page | Page | Element strony, który ma zostać skopiowany i wklejony. |
Powrót
Page
– wstawiony element strony.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shape)
Wstawia na stronie kopię podanego elementu Shape
.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z bieżącej prezentacji, właściwości dziedziczone z mastera lub stron układu są również dziedziczone przez wstawiany element.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z innej prezentacji, właściwości dziedziczone z głównej strony lub stron układu są kopiowane do elementu z prezentacji źródłowej.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
shape | Shape | Kształt, który ma zostać skopiowany i wstawiony. |
Powrót
Shape
– wstawiony kształt.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shapeType)
Wstawia kształt na stronie.
Kształt jest wstawiany w domyślnym rozmiarze w lewym górnym rogu strony.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
shape | Shape | Typ kształtu do wstawienia. |
Powrót
Shape
– wstawiony kształt.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shapeType, left, top, width, height)
Wstawia kształt na stronie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
shape | Shape | Typ kształtu do wstawienia. |
left | Number | Pozycja pozioma kształtu, mierzona od lewego górnego rogu strony. |
top | Number | Pozycja pionowa kształtu, mierzona od lewego górnego rogu strony. |
width | Number | Szerokość kształtu. |
height | Number | Wysokość kształtu. |
Powrót
Shape
– wstawiony kształt.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sourceChart)
Wstawia na stronie wykres z Arkuszy Google.
Wykres jest wstawiany w domyślnym rozmiarze w lewym górnym rogu strony.
Wstawiony wykres jest połączony z wykresem źródłowym w Arkuszach Google, co umożliwia jego aktualizowanie. Inni współpracownicy mogą zobaczyć link do źródłowego arkusza kalkulacyjnego.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
source | Embedded | wykres w arkuszu kalkulacyjnym, który chcesz wstawić na stronie; |
Powrót
Sheets
– wstawiony wykres na stronie.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sourceChart, left, top, width, height)
Wstawia wykres arkuszy Google na stronie w podanym położeniu i rozmiarze.
Aby zachować format obrazu, wykres jest skalowany i wyśrodkowy względem podanego rozmiaru.
Wstawiony wykres jest połączony z wykresem źródłowym w Arkuszach Google, co umożliwia jego aktualizowanie. Inni współpracownicy mogą zobaczyć link do źródłowego arkusza kalkulacyjnego.
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, );
Parametry
Nazwa | Typ | Opis |
---|---|---|
source | Embedded | wykres w arkuszu kalkulacyjnym, który chcesz wstawić na stronie; |
left | Number | Pozycja pozioma wykresu w punktach, mierzona od lewego górnego rogu strony. |
top | Number | Pozycja pionowa wykresu w punktach, mierzona od lewego górnego rogu strony. |
width | Number | Szerokość wykresu w punktach. |
height | Number | Wysokość wykresu w punktach. |
Powrót
Sheets
– wstawiony wykres na stronie.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sheetsChart)
Wstawia na stronie kopię podanego elementu Sheets
.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z bieżącej prezentacji, właściwości dziedziczone z mastera lub stron układu są również dziedziczone przez wstawiany element.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z innej prezentacji, właściwości dziedziczone z głównej strony lub stron układu są kopiowane do elementu z prezentacji źródłowej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
sheets | Sheets | wykres arkuszy do skopiowania i wstawienia. |
Powrót
Sheets
– wstawiony wykres arkuszy.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart As Image(sourceChart)
Wstawia wykres z Arkuszy Google jako Image
na stronie.
Obraz wykresu jest wstawiany w domyślnym rozmiarze w lewym górnym rogu strony.
Wstawiony obraz wykresu nie jest połączony z wykresem źródłowym z Arkuszy Google.
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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
source | Embedded | wykres w arkuszu kalkulacyjnym, który chcesz wstawić na stronie; |
Powrót
Image
– wstawiony na stronie obraz wykresu.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart As Image(sourceChart, left, top, width, height)
Wstawia wykres z Arkuszy Google jako element Image
na stronie w wybranej pozycji i rozmiarze.
Aby zachować współczynnik proporcji obrazu wykresu, obraz jest skalowany i wyśrodkowywany względem podanego rozmiaru.
Wstawiony obraz wykresu nie jest połączony z wykresem źródłowym w Arkuszach Google.
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, );
Parametry
Nazwa | Typ | Opis |
---|---|---|
source | Embedded | wykres w arkuszu kalkulacyjnym, który chcesz wstawić na stronie; |
left | Number | Pozycja pozioma wykresu w punktach, mierzona od lewego górnego rogu strony. |
top | Number | Pozycja pionowa wykresu w punktach, mierzona od lewego górnego rogu strony. |
width | Number | Szerokość wykresu w punktach. |
height | Number | Wysokość wykresu w punktach. |
Powrót
Image
– wstawiony na stronie obraz wykresu.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(numRows, numColumns)
Wstawia tabelę na stronie.
Tabela jest wyśrodkowana na stronie, ma domyślny rozmiar i ma równomiernie rozmieszczone wiersze i kolumny.
Parametry
Nazwa | Typ | Opis |
---|---|---|
num | Integer | Liczba wierszy w tabeli. |
num | Integer | Liczba kolumn w tabeli. |
Powrót
Table
– wstawiona tabela.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(numRows, numColumns, left, top, width, height)
Wstawia tabelę na stronie w podanym położeniu i rozmiarze.
Wiersze i kolumny są równomiernie rozmieszczone w utworzonej tabeli.
Parametry
Nazwa | Typ | Opis |
---|---|---|
num | Integer | Liczba wierszy w tabeli. |
num | Integer | Liczba kolumn w tabeli. |
left | Number | Pozycja pozioma tabeli mierzona od lewego górnego rogu strony. |
top | Number | Pozycja pionowa tabeli mierzona od lewego górnego rogu strony. |
width | Number | Szerokość tabeli. |
height | Number | Minimalna wysokość tabeli. Rzeczywista wysokość wyrenderowanej tabeli zależy od takich czynników jak rozmiar czcionki tekstu. |
Powrót
Table
– wstawiona tabela.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(table)
Wstawia na stronie kopię podanego elementu Table
.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z bieżącej prezentacji, właściwości dziedziczone z mastera lub stron układu są również dziedziczone przez wstawiany element.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z innej prezentacji, właściwości dziedziczone z głównej strony lub stron układu są kopiowane do elementu z prezentacji źródłowej.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
table | Table | Tabela do skopiowania i wstawienia. |
Powrót
Table
– wstawiona tabela.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Text Box(text)
Wstawia na stronie pole tekstowe Shape
zawierające podany ciąg znaków.
W lewym górnym rogu strony wstawiany jest kształt pola tekstowego o domyślnym rozmiarze.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Ciąg tekstowy, który powinno zawierać pole tekstowe. |
Powrót
Shape
– kształt wstawionego pola tekstowego.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Text Box(text, left, top, width, height)
Wstawia na stronie pole tekstowe Shape
zawierające podany ciąg znaków.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Ciąg tekstowy, który powinno zawierać pole tekstowe. |
left | Number | Pozycja pozioma kształtu pola tekstowego mierzona od lewego górnego rogu strony. |
top | Number | Pozycja pionowa kształtu pola tekstowego, mierzona od lewego górnego rogu strony. |
width | Number | Szerokość kształtu pola tekstowego. |
height | Number | Wysokość kształtu pola tekstowego. |
Powrót
Shape
– kształt wstawionego pola tekstowego.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(videoUrl)
Wstawia film w lewym górnym rogu strony w domyślnym rozmiarze.
Obecnie obsługiwane są tylko filmy z YouTube.
Parametry
Nazwa | Typ | Opis |
---|---|---|
video | String | Adres URL filmu, który chcesz wstawić. |
Powrót
Video
– wstawiony film.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(videoUrl, left, top, width, height)
Wstawia film na stronie w określonej pozycji i rozmiarze.
Obecnie obsługiwane są tylko filmy z YouTube.
Parametry
Nazwa | Typ | Opis |
---|---|---|
video | String | Adres URL filmu, który chcesz wstawić. |
left | Number | Pozycja pozioma filmu w punktach, mierzona od lewego górnego rogu strony. |
top | Number | Pozycja pionowa filmu w punktach, mierzona od lewego górnego rogu strony. |
width | Number | Szerokość filmu w punktach. |
height | Number | Wysokość filmu w punktach. |
Powrót
Video
– wstawiony film.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(video)
Wstawia na stronie kopię podanego elementu Video
.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z bieżącej prezentacji, właściwości dziedziczone z mastera lub stron układu są również dziedziczone przez wstawiany element.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z innej prezentacji, właściwości dziedziczone z głównej strony lub stron układu są kopiowane do elementu z prezentacji źródłowej.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
video | Video | Film, który ma zostać skopiowany i wstawiony. |
Powrót
Video
– wstawiony film.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Word Art(wordArt)
Wstawia na stronie kopię podanego elementu Word
.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z bieżącej prezentacji, właściwości dziedziczone z mastera lub stron układu są również dziedziczone przez wstawiany element.
Jeśli podany element jest miejscem substytucyjnym kopiowanym z innej prezentacji, właściwości dziedziczone z głównej strony lub stron układu są kopiowane do elementu z prezentacji źródłowej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
word | Word | Grupa, która ma zostać skopiowana i wstawiona. |
Powrót
Word
– wstawiony obiekt WordArt.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Usuwa stronę.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText)
Zastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia. Wielkość liter nie ma znaczenia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
find | String | Tekst do znalezienia. |
replace | String | Tekst, który ma zastąpić dopasowany tekst. |
Powrót
Integer
– zmieniona liczba wystąpień
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText, matchCase)
Zastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
find | String | Tekst do znalezienia. |
replace | String | Tekst, który ma zastąpić dopasowany tekst. |
match | Boolean | Jeśli true , wyszukiwanie uwzględnia wielkość liter; jeśli false , wielkość liter nie ma znaczenia. |
Powrót
Integer
– zmieniona liczba wystąpień
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select As Current Page()
Wybiera Page
w aktywnej prezentacji jako current page selection
i usuwa poprzednią selekcję.
Skrypt może uzyskać dostęp tylko do elementów wybranych przez użytkownika, który go uruchamia, i tylko wtedy, gdy skrypt jest powiązany z prezentacją.
// 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.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations