Mistrz w prezentacji.
Elementy nadrzędne zawierają wszystkie typowe elementy stron i wspólne właściwości zestawu układów. Służą one do 3 celów:
- Kształty zastępcze w elemencie głównym zawierają domyślne style tekstu i właściwości kształtów wszystkich kształtów zastępczych na stronach, które korzystają z tego wzorca.
- Właściwości strony głównej określają wspólne właściwości strony dziedziczone przez jej układy.
- Pozostałe kształty na slajdzie głównym pojawiają się na wszystkich slajdach korzystających z tego wzorca, niezależnie od ich układu.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getBackground() | PageBackground | Pobiera tło strony. |
getColorScheme() | ColorScheme | Pobiera element ColorScheme powiązany ze stroną. |
getGroups() | Group[] | Zwraca listę obiektów Group na stronie. |
getImages() | Image[] | Zwraca listę obiektów Image na stronie. |
getLayouts() | Layout[] | Pobiera układy tego wzorca. |
getLines() | Line[] | Zwraca listę obiektów Line na stronie. |
getObjectId() | String | Pobiera unikalny identyfikator strony. |
getPageElementById(id) | PageElement | Zwraca PageElement na stronie o podanym identyfikatorze lub null , jeśli nie istnieje. |
getPageElements() | PageElement[] | Zwraca listę obiektów PageElement wyrenderowanych na stronie. |
getPageType() | PageType | Pobiera typ strony. |
getPlaceholder(placeholderType) | PageElement | Zwraca obiekt zastępczy PageElement dla określonego elementu PlaceholderType lub null , jeśli odpowiedni obiekt zastępczy nie istnieje. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | Zwraca obiekt zastępczy PageElement dla określonego elementu PlaceholderType i indeksu obiektu zastępczego lub null , jeśli obiekt zastępczy nie jest obecny. |
getPlaceholders() | PageElement[] | Zwraca listę zastępczych obiektów PageElement na stronie. |
getShapes() | Shape[] | Zwraca listę obiektów Shape na stronie. |
getSheetsCharts() | SheetsChart[] | Zwraca listę obiektów SheetsChart na stronie. |
getTables() | Table[] | Zwraca listę obiektów Table na stronie. |
getVideos() | Video[] | Zwraca listę obiektów Video na stronie. |
getWordArts() | WordArt[] | Zwraca listę obiektów WordArt na stronie. |
group(pageElements) | Group | Grupuje wszystkie określone elementy strony. |
insertGroup(group) | Group | Wstawia kopię podanego Group na stronie. |
insertImage(blobSource) | Image | Wstawia obraz w lewym górnym rogu strony w domyślnym rozmiarze z określonego obiektu blob obrazu. |
insertImage(blobSource, left, top, width, height) | Image | Wstawia na stronie obraz w podanej pozycji i rozmiarze ze wskazanego obiektu blob obrazu. |
insertImage(image) | Image | Wstawia kopię podanego Image na stronie. |
insertImage(imageUrl) | Image | Wstawia obraz w lewym górnym rogu strony w domyślnym rozmiarze z podanego adresu URL. |
insertImage(imageUrl, left, top, width, height) | Image | Wstawia na stronie obraz w podanej pozycji i rozmiarze z podanego adresu URL. |
insertLine(line) | Line | Wstawia kopię podanego Line na stronie. |
insertLine(lineCategory, startConnectionSite, endConnectionSite) | Line | Wstawia na stronie wiersz łączący dwa elementy connection sites . |
insertLine(lineCategory, startLeft, startTop, endLeft, endTop) | Line | Wstawia wiersz na stronie. |
insertPageElement(pageElement) | PageElement | Wstawia kopię podanego PageElement na stronie. |
insertShape(shape) | Shape | Wstawia kopię podanego Shape na stronie. |
insertShape(shapeType) | Shape | Wstawia kształt na stronie. |
insertShape(shapeType, left, top, width, height) | Shape | Wstawia kształt na stronie. |
insertSheetsChart(sourceChart) | SheetsChart | Wstawia na stronie wykres z Arkuszy Google. |
insertSheetsChart(sourceChart, left, top, width, height) | SheetsChart | Wstawia na stronie wykres z Arkuszy Google w podanej pozycji i rozmiarze. |
insertSheetsChart(sheetsChart) | SheetsChart | Wstawia kopię podanego SheetsChart na stronie. |
insertSheetsChartAsImage(sourceChart) | Image | Wstawia wykres z Arkuszy Google jako element Image na stronie. |
insertSheetsChartAsImage(sourceChart, left, top, width, height) | Image | Wstawia wykres z Arkuszy Google jako element Image na stronie z podaną pozycją i rozmiarem. |
insertTable(numRows, numColumns) | Table | Wstawia tabelę na stronie. |
insertTable(numRows, numColumns, left, top, width, height) | Table | Wstawia na stronie tabelę w podanej pozycji i rozmiarze. |
insertTable(table) | Table | Wstawia kopię podanego Table na stronie. |
insertTextBox(text) | Shape | Wstawia pole tekstowe Shape zawierające podany ciąg znaków na stronie. |
insertTextBox(text, left, top, width, height) | Shape | Wstawia pole tekstowe Shape zawierające podany ciąg znaków na stronie. |
insertVideo(videoUrl) | Video | Wstawia film w lewym górnym rogu strony w domyślnym rozmiarze. |
insertVideo(videoUrl, left, top, width, height) | Video | Wstawia na stronie film w podanej pozycji i rozmiarze. |
insertVideo(video) | Video | Wstawia kopię podanego Video na stronie. |
insertWordArt(wordArt) | WordArt | Wstawia kopię podanego WordArt na stronie. |
remove() | void | Usuwa stronę. |
replaceAllText(findText, replaceText) | Integer | Zastępuje wszystkie wystąpienia pasującego tekstu do znalezienia tekstu przez funkcję zamiany tekstu. |
replaceAllText(findText, replaceText, matchCase) | Integer | Zastępuje wszystkie wystąpienia pasującego tekstu do znalezienia tekstu przez funkcję zamiany tekstu. |
selectAsCurrentPage() | void | Powoduje zaznaczenie elementu Page w aktywnej prezentacji jako current page selection i usuwa wszystkie wcześniejsze zaznaczenia. |
Szczegółowa dokumentacja
getBackground()
Pobiera tło strony.
Powroty
PageBackground
– tło strony;
Upoważnienie
Skrypty korzystające 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
getColorScheme()
Pobiera element ColorScheme
powiązany ze stroną.
Powroty
ColorScheme
– schemat kolorów strony.
Upoważnienie
Skrypty korzystające 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
getGroups()
getImages()
getLayouts()
getLines()
getObjectId()
Pobiera unikalny identyfikator strony. Identyfikatory obiektów używane przez strony i elementy stron mają tę samą przestrzeń nazw.
Powroty
String
Upoważnienie
Skrypty korzystające 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
getPageElementById(id)
Zwraca PageElement
na stronie o podanym identyfikatorze lub null
, jeśli nie istnieje.
Parametry
Nazwa | Typ | Opis |
---|---|---|
id | String | Identyfikator pobieranego elementu strony. |
Powroty
PageElement
– element strony o podanym identyfikatorze.
Upoważnienie
Skrypty korzystające 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
getPageElements()
Zwraca listę obiektów PageElement
wyrenderowanych na stronie.
Powroty
Upoważnienie
Skrypty korzystające 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
getPageType()
getPlaceholder(placeholderType)
Zwraca obiekt zastępczy PageElement
dla określonego elementu PlaceholderType
lub null
, jeśli odpowiedni obiekt zastępczy nie istnieje.
Jeśli jest wiele obiektów zastępczych tego samego typu, zwracany jest ten z minimalnym indeksem zastępczym. Jeśli istnieje wiele pasujących obiektów zastępczych z tym samym indeksem, zwracana jest pierwsza z nich z kolekcji elementów strony.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
Parametry
Nazwa | Typ | Opis |
---|---|---|
placeholderType | PlaceholderType |
Powroty
Upoważnienie
Skrypty korzystające 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
getPlaceholder(placeholderType, placeholderIndex)
Zwraca obiekt zastępczy PageElement
dla określonego elementu PlaceholderType
i indeksu obiektu zastępczego lub null
, jeśli obiekt zastępczy nie jest obecny.
Jeśli jest wiele obiektów zastępczych o tym samym typie i indeksie, zwracana jest pierwsza z kolekcji elementów strony.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);
Parametry
Nazwa | Typ | Opis |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
Powroty
Upoważnienie
Skrypty korzystające 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
getPlaceholders()
Zwraca listę zastępczych obiektów PageElement
na stronie.
var master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);
Powroty
Upoważnienie
Skrypty korzystające 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
getShapes()
getSheetsCharts()
Zwraca listę obiektów SheetsChart
na stronie.
Powroty
Upoważnienie
Skrypty korzystające 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
getTables()
getVideos()
getWordArts()
group(pageElements)
Grupuje wszystkie określone elementy strony.
Na tej samej stronie powinny znajdować się co najmniej dwa elementy, których nie ma jeszcze w innej grupie. Niektórych elementów stron, takich jak Videos
, Tables
i placeholder Shapes
, nie można grupować.
Parametry
Nazwa | Typ | Opis |
---|---|---|
pageElements | PageElement[] | Elementy do zgrupowania. |
Powroty
Group
– nowa grupa.
Upoważnienie
Skrypty korzystające 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
insertGroup(group)
Wstawia kopię podanego Group
na stronie.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest symbolem zastępczym kopiowanym z bieżącej prezentacji, właściwości dziedziczące ze stron głównych lub stron układu również dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone ze stron głównych lub stron układu są kopiowane z prezentacji źródłowej.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
group | Group | Grupa do skopiowania i wstawienia. |
Powroty
Group
– wstawiona grupa.
Upoważnienie
Skrypty korzystające 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
insertImage(blobSource)
Wstawia obraz w lewym górnym rogu strony w domyślnym rozmiarze z określonego obiektu blob obrazu.
Wstawienie obrazu powoduje jednorazowe pobranie go z szablonu BlobSource
i zapisanie jego kopii do wyświetlenia w prezentacji. Obrazy muszą być mniejsze niż 50 MB i nie mogą przekraczać 25 megapikseli, a także muszą być w formacie PNG, JPEG lub GIF.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); slide.insertImage(image);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Dane obrazu. |
Powroty
Image
– wstawiony obraz.
Upoważnienie
Skrypty korzystające 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
insertImage(blobSource, left, top, width, height)
Wstawia na stronie obraz w podanej pozycji i rozmiarze ze wskazanego obiektu blob obrazu.
Podczas wstawiania obraz jest pobierany z przesłanego pliku BlobSource
, a jego kopia jest przechowywana w celu wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB,
nie może przekraczać 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.
Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany w odniesieniu do podanego rozmiaru.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Dane obrazu. |
left | Number | Pozioma pozycja obrazu w punktach mierzona od lewego górnego rogu strony. |
top | Number | Pionowa pozycja obrazu w punktach mierzona od lewego górnego rogu strony. |
width | Number | Szerokość obrazu w punktach. |
height | Number | Wysokość obrazu w punktach. |
Powroty
Image
– wstawiony obraz.
Upoważnienie
Skrypty korzystające 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
insertImage(image)
Wstawia kopię podanego Image
na stronie.
Pozycja wstawionych obrazów na stronie jest określana na podstawie pozycji obrazu źródłowego na odpowiedniej stronie.
Jeśli przesłany obraz jest symbolem zastępczym kopiowanym z bieżącej prezentacji, właściwości dziedziczące ze stron głównych lub stron układu również dziedziczą ze wstawionego obrazu.
Jeśli przesłany obraz jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone ze stron głównych lub stron układu są kopiowane z prezentacji źródłowej. Jeśli skopiowany obraz zastępczy jest pusty, do docelowej prezentacji nic nie zostanie wstawione.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
image | Image | Obraz do skopiowania i wstawienia. |
Powroty
Image
– wstawiony obraz.
Upoważnienie
Skrypty korzystające 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
insertImage(imageUrl)
Wstawia obraz w lewym górnym rogu strony w domyślnym rozmiarze z podanego adresu URL.
Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL, a jego kopia zostaje zapisana i wyświetlana w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także format PNG, JPEG lub GIF.
Podany adres URL musi być publicznie dostępny, a jego rozmiar nie może przekraczać 2 KB. Adres URL jest zapisywany wraz z obrazem i wyświetlany w elemencie Image.getSourceUrl()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL obrazu. |
Powroty
Image
– wstawiony obraz.
Upoważnienie
Skrypty korzystające 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
insertImage(imageUrl, left, top, width, height)
Wstawia na stronie obraz w podanej pozycji i rozmiarze z podanego adresu URL.
Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL, a jego kopia zostaje zapisana i wyświetlana w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także format PNG, JPEG lub GIF.
Podany adres URL musi być publicznie dostępny, a jego rozmiar nie może przekraczać 2 KB. Adres URL jest zapisywany wraz z obrazem i wyświetlany w elemencie Image.getSourceUrl()
.
Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany w odniesieniu do podanego rozmiaru.
Parametry
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL obrazu. |
left | Number | Pozioma pozycja obrazu w punktach mierzona od lewego górnego rogu strony. |
top | Number | Pionowa pozycja obrazu w punktach mierzona od lewego górnego rogu strony. |
width | Number | Szerokość obrazu w punktach. |
height | Number | Wysokość obrazu w punktach. |
Powroty
Image
– wstawiony obraz.
Upoważnienie
Skrypty korzystające 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
insertLine(line)
Wstawia kopię podanego Line
na stronie.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest symbolem zastępczym kopiowanym z bieżącej prezentacji, właściwości dziedziczące ze stron głównych lub stron układu również dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone ze stron głównych lub stron układu są kopiowane z prezentacji źródłowej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
line | Line | Wiersz do skopiowania i wstawienia. |
Powroty
Line
– wstawiony wiersz.
Upoważnienie
Skrypty korzystające 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
insertLine(lineCategory, startConnectionSite, endConnectionSite)
Wstawia na stronie wiersz łączący dwa elementy connection sites
. Obie witryny muszą się znajdować na tej stronie.
// 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]);
Parametry
Nazwa | Typ | Opis |
---|---|---|
lineCategory | LineCategory | Kategoria wiersza do wstawienia. |
startConnectionSite | ConnectionSite | Miejsce połączenia, w którym ma być połączony początek wiersza. |
endConnectionSite | ConnectionSite | Miejsce połączenia, w którym ma być połączony koniec wiersza. |
Powroty
Line
– wstawiony wiersz.
Upoważnienie
Skrypty korzystające 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
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)
Wstawia wiersz na stronie.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
lineCategory | LineCategory | Kategoria wiersza do wstawienia. |
startLeft | Number | Pozioma pozycja punktu początkowego linii mierzona w punktach od lewego górnego rogu strony. |
startTop | Number | Pionowe położenie punktu początkowego linii mierzone w punktach od lewego górnego rogu strony. |
endLeft | Number | Pozioma pozycja punktu końcowego linii mierzona w punktach od lewego górnego rogu strony. |
endTop | Number | Położenie punktu końcowego linii w pionie mierzone w punktach od lewego górnego rogu strony. |
Powroty
Line
– wstawiony wiersz.
Upoważnienie
Skrypty korzystające 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
insertPageElement(pageElement)
Wstawia kopię podanego PageElement
na stronie.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest symbolem zastępczym kopiowanym z bieżącej prezentacji, właściwości dziedziczące ze stron głównych lub stron układu również dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone ze stron głównych lub stron układu są kopiowane z prezentacji źródłowej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
pageElement | PageElement | Element strony, który ma zostać skopiowany i wstawiony. |
Powroty
PageElement
– element wstawiony do strony.
Upoważnienie
Skrypty korzystające 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
insertShape(shape)
Wstawia kopię podanego Shape
na stronie.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest symbolem zastępczym kopiowanym z bieżącej prezentacji, właściwości dziedziczące ze stron głównych lub stron układu również dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone ze stron głównych lub stron układu są kopiowane z prezentacji źródłowej.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
shape | Shape | Kształt do skopiowania i wstawienia. |
Powroty
Shape
– wstawiony kształt.
Upoważnienie
Skrypty korzystające 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
insertShape(shapeType)
Wstawia kształt na stronie.
Kształt zostanie wstawiony z domyślnym rozmiarem w lewym górnym rogu strony.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
shapeType | ShapeType | Typ kształtu do wstawienia. |
Powroty
Shape
– wstawiony kształt.
Upoważnienie
Skrypty korzystające 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
insertShape(shapeType, left, top, width, height)
Wstawia kształt na stronie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
shapeType | ShapeType | Typ kształtu do wstawienia. |
left | Number | Pozioma pozycja kształtu mierzona od lewego górnego rogu strony. |
top | Number | Położenie kształtu w pionie mierzone od lewego górnego rogu strony. |
width | Number | Szerokość kształtu. |
height | Number | Wysokość kształtu. |
Powroty
Shape
– wstawiony kształt.
Upoważnienie
Skrypty korzystające 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
insertSheetsChart(sourceChart)
Wstawia na stronie wykres z Arkuszy Google.
Wykres zostanie wstawiony w lewym górnym rogu strony z rozmiarem domyślnym.
Wstawiony wykres jest połączony ze źródłowym wykresem w Arkuszach Google, co umożliwia jego aktualizowanie. Inni współpracownicy mogą zobaczyć link do źródłowego arkusza kalkulacyjnego.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
sourceChart | EmbeddedChart | Wykres w arkuszu kalkulacyjnym do wstawienia na stronie. |
Powroty
SheetsChart
– wykres wstawiony na stronie.
Upoważnienie
Skrypty korzystające 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
insertSheetsChart(sourceChart, left, top, width, height)
Wstawia na stronie wykres z Arkuszy Google w podanej pozycji i rozmiarze.
Aby zachować współczynnik proporcji wykresu, jest on skalowany i wyśrodkowany w odniesieniu do podanego rozmiaru.
Wstawiony wykres jest połączony ze źródłowym wykresem w Arkuszach Google, co umożliwia jego aktualizowanie. Inni współpracownicy mogą zobaczyć link do źródłowego arkusza kalkulacyjnego.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
sourceChart | EmbeddedChart | Wykres w arkuszu kalkulacyjnym do wstawienia na stronie. |
left | Number | Pozioma pozycja wykresu w punktach mierzona od lewego górnego rogu strony. |
top | Number | Pionowa pozycja wykresu w punktach mierzona od lewego górnego rogu strony. |
width | Number | Szerokość wykresu w punktach. |
height | Number | Wysokość wykresu w punktach. |
Powroty
SheetsChart
– wykres wstawiony na stronie.
Upoważnienie
Skrypty korzystające 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
insertSheetsChart(sheetsChart)
Wstawia kopię podanego SheetsChart
na stronie.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest symbolem zastępczym kopiowanym z bieżącej prezentacji, właściwości dziedziczące ze stron głównych lub stron układu również dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone ze stron głównych lub stron układu są kopiowane z prezentacji źródłowej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
sheetsChart | SheetsChart | Wykres w Arkuszach, który chcesz skopiować i wstawić. |
Powroty
SheetsChart
– wykres wstawionych w arkuszu kalkulacyjnym.
Upoważnienie
Skrypty korzystające 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
insertSheetsChartAsImage(sourceChart)
Wstawia wykres z Arkuszy Google jako element Image
na stronie.
Obraz wykresu zostanie wstawiony z domyślnym rozmiarem w lewym górnym rogu strony.
Wstawiony obraz wykresu nie jest połączony ze źródłowym wykresem w Arkuszach Google.
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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
sourceChart | EmbeddedChart | Wykres w arkuszu kalkulacyjnym do wstawienia na stronie. |
Powroty
Image
– obraz wykresu wstawiony na stronie.
Upoważnienie
Skrypty korzystające 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
insertSheetsChartAsImage(sourceChart, left, top, width, height)
Wstawia wykres z Arkuszy Google jako element Image
na stronie z podaną pozycją i rozmiarem.
Aby zachować współczynnik proporcji obrazu na wykresie, obraz jest przeskalowywany i wyśrodkowany z uwzględnieniem podanego rozmiaru.
Wstawiony obraz wykresu nie jest połączony ze źródłowym wykresem w Arkuszach Google.
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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
sourceChart | EmbeddedChart | Wykres w arkuszu kalkulacyjnym do wstawienia na stronie. |
left | Number | Pozioma pozycja wykresu w punktach mierzona od lewego górnego rogu strony. |
top | Number | Pionowa pozycja wykresu w punktach mierzona od lewego górnego rogu strony. |
width | Number | Szerokość wykresu w punktach. |
height | Number | Wysokość wykresu w punktach. |
Powroty
Image
– obraz wykresu wstawiony na stronie.
Upoważnienie
Skrypty korzystające 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
insertTable(numRows, numColumns)
Wstawia tabelę na stronie.
Tabela jest wyśrodkowana na stronie i ma domyślny rozmiar oraz równomiernie rozmieszczone wiersze i kolumny.
Parametry
Nazwa | Typ | Opis |
---|---|---|
numRows | Integer | Liczba wierszy w tabeli. |
numColumns | Integer | Liczba kolumn w tabeli. |
Powroty
Table
– wstawiona tabela.
Upoważnienie
Skrypty korzystające 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
insertTable(numRows, numColumns, left, top, width, height)
Wstawia na stronie tabelę w podanej pozycji i rozmiarze.
Wiersze i kolumny w utworzonej tabeli są równomiernie rozłożone.
Parametry
Nazwa | Typ | Opis |
---|---|---|
numRows | Integer | Liczba wierszy w tabeli. |
numColumns | Integer | Liczba kolumn w tabeli. |
left | Number | Pozioma pozycja tabeli mierzona od lewego górnego rogu strony. |
top | Number | Pionowa pozycja tabeli mierzona od lewego górnego rogu strony. |
width | Number | Szerokość tabeli. |
height | Number | Minimalna wysokość tabeli. Rzeczywista wysokość renderowanej tabeli zależy od takich czynników jak rozmiar czcionki tekstu. |
Powroty
Table
– wstawiona tabela.
Upoważnienie
Skrypty korzystające 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
insertTable(table)
Wstawia kopię podanego Table
na stronie.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest symbolem zastępczym kopiowanym z bieżącej prezentacji, właściwości dziedziczące ze stron głównych lub stron układu również dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone ze stron głównych lub stron układu są kopiowane z prezentacji źródłowej.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
table | Table | Tabela do skopiowania i wstawienia. |
Powroty
Table
– wstawiona tabela.
Upoważnienie
Skrypty korzystające 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
insertTextBox(text)
Wstawia pole tekstowe Shape
zawierające podany ciąg znaków na stronie.
Kształt pola tekstowego zostanie wstawiony z domyślnym rozmiarem w lewym górnym rogu strony.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Ciąg tekstowy, który powinien zawierać kształt pola tekstowego. |
Powroty
Shape
– kształt wstawionego pola tekstowego.
Upoważnienie
Skrypty korzystające 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
insertTextBox(text, left, top, width, height)
Wstawia pole tekstowe Shape
zawierające podany ciąg znaków na stronie.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Ciąg tekstowy, który powinien zawierać kształt pola tekstowego. |
left | Number | Pozioma pozycja kształtu pola tekstowego mierzona od lewego górnego rogu strony. |
top | Number | Położenie pionowe kształtu pola tekstowego mierzone od lewego górnego rogu strony. |
width | Number | Szerokość kształtu pola tekstowego. |
height | Number | Wysokość kształtu pola tekstowego. |
Powroty
Shape
– kształt wstawionego pola tekstowego.
Upoważnienie
Skrypty korzystające 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
insertVideo(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 |
---|---|---|
videoUrl | String | Adres URL filmu do wstawienia. |
Powroty
Video
– wstawiony film.
Upoważnienie
Skrypty korzystające 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
insertVideo(videoUrl, left, top, width, height)
Wstawia na stronie film w podanej pozycji i rozmiarze.
Obecnie obsługiwane są tylko filmy z YouTube.
Parametry
Nazwa | Typ | Opis |
---|---|---|
videoUrl | String | Adres URL filmu do wstawienia. |
left | Number | Pozioma pozycja filmu w punktach mierzona od lewego górnego rogu strony. |
top | Number | Pionowa pozycja filmu w punktach mierzona od lewego górnego rogu strony. |
width | Number | Szerokość filmu w punktach. |
height | Number | Wysokość filmu w punktach. |
Powroty
Video
– wstawiony film.
Upoważnienie
Skrypty korzystające 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
insertVideo(video)
Wstawia kopię podanego Video
na stronie.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest symbolem zastępczym kopiowanym z bieżącej prezentacji, właściwości dziedziczące ze stron głównych lub stron układu również dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone ze stron głównych lub stron układu są kopiowane z prezentacji źródłowej.
// 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.
Parametry
Nazwa | Typ | Opis |
---|---|---|
video | Video | Film, który chcesz skopiować i wstawić. |
Powroty
Video
– wstawiony film.
Upoważnienie
Skrypty korzystające 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
insertWordArt(wordArt)
Wstawia kopię podanego WordArt
na stronie.
Pozycja wstawionego elementu na tej stronie jest określana na podstawie pozycji elementu źródłowego na odpowiedniej stronie.
Jeśli podany element jest symbolem zastępczym kopiowanym z bieżącej prezentacji, właściwości dziedziczące ze stron głównych lub stron układu również dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone ze stron głównych lub stron układu są kopiowane z prezentacji źródłowej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
wordArt | WordArt | Grupa do skopiowania i wstawienia. |
Powroty
WordArt
– wstawiony tekst WordArt.
Upoważnienie
Skrypty korzystające 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ę.
Upoważnienie
Skrypty korzystające 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
replaceAllText(findText, replaceText)
Zastępuje wszystkie wystąpienia pasującego tekstu do znalezienia tekstu przez funkcję zamiany tekstu. Wielkość liter nie jest rozróżniana.
Parametry
Nazwa | Typ | Opis |
---|---|---|
findText | String | Tekst do znalezienia. |
replaceText | String | Tekst, który ma zastąpić dopasowany tekst. |
Powroty
Integer
– liczba zmian;
Upoważnienie
Skrypty korzystające 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
replaceAllText(findText, replaceText, matchCase)
Zastępuje wszystkie wystąpienia pasującego tekstu do znalezienia tekstu przez funkcję zamiany tekstu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
findText | String | Tekst do znalezienia. |
replaceText | String | Tekst, który ma zastąpić dopasowany tekst. |
matchCase | Boolean | Jeśli wybierzesz true , wielkość liter ma znaczenie. Jeśli wybierzesz false , wielkość liter nie będzie rozróżniana. |
Powroty
Integer
– liczba zmian;
Upoważnienie
Skrypty korzystające 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
selectAsCurrentPage()
Powoduje zaznaczenie elementu Page
w aktywnej prezentacji jako current page selection
i usuwa wszystkie wcześniejsze zaznaczenia.
Skrypt ma dostęp tylko do użytkownika, który ma go uruchamiać, i tylko wtedy, gdy jest powiązany z prezentacją.
// 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.
Upoważnienie
Skrypty korzystające 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