Układ w prezentacji.
Każdy układ służy jako szablon slajdów, które dziedziczą z tego elementu, określając sposób porządkowania i stylu treści tych slajdów.
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. |
getLayoutName() | String | Pobiera nazwę układu. |
getLines() | Line[] | Zwraca listę obiektów Line na stronie. |
getMaster() | Master | Pobiera wzorzec, na którym jest oparty układ. |
getObjectId() | String | Pobiera unikalny identyfikator strony. |
getPageElementById(id) | PageElement | Zwraca wartość PageElement na stronie o podanym identyfikatorze lub wartość null , jeśli nie istnieje. |
getPageElements() | PageElement[] | Zwraca listę PageElement obiektów renderowanych na stronie. |
getPageType() | PageType | Pobiera typ strony. |
getPlaceholder(placeholderType) | PageElement | Zwraca obiekt PageElement w przypadku określonego obiektu PlaceholderType lub null , jeśli nie pasuje do niego obiekt zastępczy. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | Zwraca obiekt PageElement w przypadku określonego ciągu PlaceholderType i 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 na stronie kopię podanego Group . |
insertImage(blobSource) | Image | Wstawia obraz w lewym górnym rogu strony w domyślnym rozmiarze ze wskazanego obiektu blob. |
insertImage(blobSource, left, top, width, height) | Image | Wstawia na stronie obraz o określonej pozycji i rozmiarze z określonego obiektu blob. |
insertImage(image) | Image | Wstawia na stronie kopię podanego Image . |
insertImage(imageUrl) | Image | Wstawia w lewym górnym rogu strony obraz w domyślnym rozmiarze z podanego adresu URL. |
insertImage(imageUrl, left, top, width, height) | Image | Wstawia na stronie obraz o danej pozycji i rozmiarze z podanego adresu URL. |
insertLine(line) | Line | Wstawia na stronie kopię podanego Line . |
insertLine(lineCategory, startConnectionSite, endConnectionSite) | Line | Wstawia na stronie wiersz łączący 2 elementy connection sites . |
insertLine(lineCategory, startLeft, startTop, endLeft, endTop) | Line | Wstawia na stronie wiersz. |
insertPageElement(pageElement) | PageElement | Wstawia na stronie kopię podanego PageElement . |
insertShape(shape) | Shape | Wstawia na stronie kopię podanego Shape . |
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 w Arkuszach Google. |
insertSheetsChart(sourceChart, left, top, width, height) | SheetsChart | Wstawia na stronie wykres w Arkuszach Google o podanej pozycji i rozmiarze. |
insertSheetsChart(sheetsChart) | SheetsChart | Wstawia na stronie kopię podanego SheetsChart . |
insertSheetsChartAsImage(sourceChart) | Image | Wstawia wykres Arkuszy Google jako Image na stronie. |
insertSheetsChartAsImage(sourceChart, left, top, width, height) | Image | Wstawia wykres Arkuszy Google jako element Image na stronie o podanej pozycji i rozmiarze. |
insertTable(numRows, numColumns) | Table | Wstawia tabelę na stronie. |
insertTable(numRows, numColumns, left, top, width, height) | Table | Wstawia na stronie tabelę z podaną pozycją i rozmiarem. |
insertTable(table) | Table | Wstawia na stronie kopię podanego Table . |
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 o podanej pozycji i rozmiarze. |
insertVideo(video) | Video | Wstawia na stronie kopię podanego Video . |
insertWordArt(wordArt) | WordArt | Wstawia na stronie kopię podanego WordArt . |
remove() | void | Usuwa stronę. |
replaceAllText(findText, replaceText) | Integer | Zamienia wszystkie wystąpienia tekstu pasującego do tekstu na tekst zastępczy. |
replaceAllText(findText, replaceText, matchCase) | Integer | Zamienia wszystkie wystąpienia tekstu pasującego do tekstu na tekst zastępczy. |
selectAsCurrentPage() | void | Zaznacza element Page w aktywnej prezentacji jako current page selection i usuwa wcześniejszy wybór. |
Szczegółowa dokumentacja
getBackground()
Pobiera tło strony.
Zwróć
PageBackground
– tło strony,
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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ą.
Zwróć
ColorScheme
– schemat kolorów strony,
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getGroups()
getImages()
getLayoutName()
Pobiera nazwę układu.
Zwróć
String
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLines()
getMaster()
getObjectId()
Pobiera unikalny identyfikator strony. Identyfikatory obiektów używane przez strony i ich elementy mają tę samą przestrzeń nazw.
Zwróć
String
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
Zwraca wartość PageElement
na stronie o podanym identyfikatorze lub wartość null
, jeśli nie istnieje.
Parametry
Nazwa | Typ | Opis |
---|---|---|
id | String | Identyfikator pobieranego elementu strony. |
Zwróć
PageElement
– element strony o podanym identyfikatorze,
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElements()
Zwraca listę PageElement
obiektów renderowanych na stronie.
Zwróć
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageType()
getPlaceholder(placeholderType)
Zwraca obiekt PageElement
w przypadku określonego obiektu PlaceholderType
lub null
, jeśli nie pasuje do niego obiekt zastępczy.
Jeśli istnieje wiele zmiennych tego samego typu, zwraca ten, który ma jak najmniejszy indeks zastępczy. Jeśli z tym samym indeksem powiązanych jest wiele zmiennych zastępczych, zwracany jest pierwszy obiekt zastępczy ze zbioru elementów strony.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
Parametry
Nazwa | Typ | Opis |
---|---|---|
placeholderType | PlaceholderType |
Zwróć
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType, placeholderIndex)
Zwraca obiekt PageElement
w przypadku określonego ciągu PlaceholderType
i obiektu zastępczego lub null
, jeśli obiekt zastępczy nie jest obecny.
Jeśli wiele elementów zastępczych z tym samym typem i indeksem zwróci pierwszy obiekt zastępczy 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 |
Zwróć
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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);
Zwróć
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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.
Zwróć
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 być co najmniej 2 elementy strony, które nie znajdują się jeszcze w innej grupie. Nie można grupować niektórych elementów strony, takich jak Videos
, Tables
i placeholder Shapes
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
pageElements | PageElement[] | Elementy do zgrupowania. |
Zwróć
Group
– nowa grupa.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertGroup(group)
Wstawia na stronie kopię podanego Group
.
Pozycja 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 dziedziczone z poziomu strony głównej lub układu też dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone z stron nadrzędnych lub układów są kopiowane do elementu 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, którą chcesz skopiować i wstawić. |
Zwróć
Group
– wstawiona grupa.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 ze wskazanego obiektu blob.
Wstawianie obrazu pobiera się raz z BlobSource
, a jego kopia jest przechowywana w celu wyświetlenia w prezentacji Rozmiar obrazu nie może przekraczać 50 MB, nie może on przekraczać 25 megapikseli oraz musi 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. |
Zwróć
Image
– wstawiony obraz.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 o określonej pozycji i rozmiarze z określonego obiektu blob.
Obraz jest pobierany z podanego BlobSource
podczas razowego wstawiania i jest przechowywany do wyświetlenia w prezentacji. Rozmiar obrazu nie może przekraczać 50 MB, nie może on przekraczać 25 megapikseli oraz musi być w formacie PNG, JPEG lub GIF.
Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany względem 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 | Pozycja pozioma obrazu w punktach, mierzona od lewego górnego rogu strony. |
top | Number | Pozycja pionowa w punktach mierzona od lewego górnego rogu strony. |
width | Number | Szerokość obrazu w punktach. |
height | Number | Wysokość obrazu w punktach. |
Zwróć
Image
– wstawiony obraz.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(image)
Wstawia na stronie kopię podanego Image
.
Pozycja umieszczonego obrazu na tej stronie jest określana na podstawie pozycji obrazu źródłowego na odpowiedniej stronie.
Jeśli podany 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ą się po wstawionym obrazie.
Jeśli podany obraz jest symbolem zastępczym skopiowanym z innej prezentacji, właściwości dziedziczone z stron nadrzędnych lub stron układu są kopiowane z obrazu źródłowego. Jeśli skopiowany obraz zastępczy jest pusty, do prezentacji docelowej nie zostaną wstawione żadne elementy.
// 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. |
Zwróć
Image
– wstawiony obraz.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl)
Wstawia w lewym górnym rogu strony obraz w domyślnym rozmiarze z podanego adresu URL.
Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL, a kopia jest przechowywana w celu wyświetlenia w ramach prezentacji. Obrazy nie mogą być większe niż 50 MB, nie mogą być większe niż 25 megapikseli oraz muszą być w formacie PNG, JPEG lub GIF.
Podany adres URL musi być dostępny publicznie i nie może przekraczać 2 kB. Sam adres URL jest zapisywany z obrazem i udostępniany za pomocą tagu Image.getSourceUrl()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL obrazu. |
Zwróć
Image
– wstawiony obraz.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 o danej pozycji i rozmiarze z podanego adresu URL.
Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL, a kopia jest przechowywana w celu wyświetlenia w ramach prezentacji. Obrazy nie mogą być większe niż 50 MB, nie mogą być większe niż 25 megapikseli oraz muszą być w formacie PNG, JPEG lub GIF.
Podany adres URL musi być dostępny publicznie i nie może przekraczać 2 kB. Sam adres URL jest zapisywany z obrazem i udostępniany za pomocą tagu Image.getSourceUrl()
.
Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany względem podanego rozmiaru.
Parametry
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL obrazu. |
left | Number | Pozycja pozioma obrazu w punktach, mierzona od lewego górnego rogu strony. |
top | Number | Pozycja pionowa w punktach mierzona od lewego górnego rogu strony. |
width | Number | Szerokość obrazu w punktach. |
height | Number | Wysokość obrazu w punktach. |
Zwróć
Image
– wstawiony obraz.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(line)
Wstawia na stronie kopię podanego Line
.
Pozycja 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 dziedziczone z poziomu strony głównej lub układu też dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone z stron nadrzędnych lub układów są kopiowane do elementu 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, który chcesz skopiować i wstawić. |
Zwróć
Line
– wstawiony wiersz.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 2 elementy connection sites
. Obie te witryny muszą być 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 linii, którą należy wstawić. |
startConnectionSite | ConnectionSite | Witryna, z którą ma zostać nawiązane połączenie na początku wiersza. |
endConnectionSite | ConnectionSite | Witryna, z którą połączony jest koniec linii. |
Zwróć
Line
– wstawiony wiersz.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)
Wstawia na stronie wiersz.
// 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 linii, którą należy wstawić. |
startLeft | Number | Pozioma pozycja punktu początkowego linii, mierzona w punktach od lewego górnego rogu strony. |
startTop | Number | Pozycja pionowa w punkcie początkowym linii mierzona w punktach od lewego górnego rogu strony. |
endLeft | Number | Pozioma pozycja punktu końcowego mierzona w punktach od lewego górnego rogu strony. |
endTop | Number | Pozycja pionowa punktu końcowego linii mierzona w punktach od lewego górnego rogu strony. |
Zwróć
Line
– wstawiony wiersz.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertPageElement(pageElement)
Wstawia na stronie kopię podanego PageElement
.
Pozycja 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 dziedziczone z poziomu strony głównej lub układu też dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone z stron nadrzędnych lub układów są kopiowane do elementu 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 do skopiowania i wstawienia. |
Zwróć
PageElement
– wstawiony element strony.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shape)
Wstawia na stronie kopię podanego Shape
.
Pozycja 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 dziedziczone z poziomu strony głównej lub układu też dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone z stron nadrzędnych lub układów są kopiowane do elementu 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, który chcesz skopiować i wstawić. |
Zwróć
Shape
– wstawiony kształt.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 jest wstawiony w lewym górnym rogu strony, a jego rozmiar domyślny.
// 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. |
Zwróć
Shape
– wstawiony kształt.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 | 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. |
Zwróć
Shape
– wstawiony kształt.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart)
Wstawia na stronie wykres w Arkuszach Google.
Wykres jest wstawiony w lewym górnym rogu strony w domyślnym rozmiarze.
Wstawiony wykres jest połączony ze źródłowym wykresem w Arkuszach Google, który umożliwia jego aktualizację. Inni współpracownicy zobaczą 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, który chcesz wstawić na stronie. |
Zwróć
SheetsChart
– wykres wstawiony na stronie.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 w Arkuszach Google o podanej pozycji i rozmiarze.
Aby zachować współczynnik proporcji wykresu, jest on przeskalowany i wyśrodkowany względem podanego rozmiaru.
Wstawiony wykres jest połączony ze źródłowym wykresem w Arkuszach Google, który umożliwia jego aktualizację. Inni współpracownicy zobaczą 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, który chcesz wstawić na stronie. |
left | Number | Pozioma pozycja wykresu w punktach (mierzona od lewego górnego rogu strony). |
top | Number | Pozycja pionowa wykresu w punktach jest mierzona w lewym górnym rogu strony. |
width | Number | Szerokość wykresu w punktach. |
height | Number | Wysokość wykresu w punktach. |
Zwróć
SheetsChart
– wykres wstawiony na stronie.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sheetsChart)
Wstawia na stronie kopię podanego SheetsChart
.
Pozycja 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 dziedziczone z poziomu strony głównej lub układu też dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone z stron nadrzędnych lub układów są kopiowane do elementu 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 Arkuszy do skopiowania i wstawienia. |
Zwróć
SheetsChart
– wykres wstawionych arkuszy.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart)
Wstawia wykres Arkuszy Google jako Image
na stronie.
Obraz wykresu jest wstawiony w domyślnym lewym górnym rogu strony w domyślnym rozmiarze.
Wstawiony obraz wykresu nie jest powiązany ze źródłowym wykresem 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, który chcesz wstawić na stronie. |
Zwróć
Image
– wstawiony obraz wykresu na stronie.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 Arkuszy Google jako element Image
na stronie o podanej pozycji i rozmiarze.
Aby zachować współczynnik proporcji obrazu na wykresie, obraz jest skalowany i wyśrodkowany zgodnie z podanym rozmiarem.
Wstawiony obraz wykresu nie jest połączony ze źródłowym wykresem 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, który chcesz wstawić na stronie. |
left | Number | Pozioma pozycja wykresu w punktach (mierzona od lewego górnego rogu strony). |
top | Number | Pozycja pionowa wykresu w punktach jest mierzona w lewym górnym rogu strony. |
width | Number | Szerokość wykresu w punktach. |
height | Number | Wysokość wykresu w punktach. |
Zwróć
Image
– wstawiony obraz wykresu na stronie.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 z domyślnym rozmiarem oraz równomiernie rozmieszczonymi wierszami i kolumnami.
Parametry
Nazwa | Typ | Opis |
---|---|---|
numRows | Integer | Liczba wierszy w tabeli. |
numColumns | Integer | Liczba kolumn w tabeli. |
Zwróć
Table
– wstawiona tabela.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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ę z podaną pozycją i rozmiarem.
Wiersze i kolumny są równomiernie rozmieszczone w utworzonej tabeli.
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 | Pozycja pionowa w tabeli mierzona w lewym górnym rogu strony. |
width | Number | Szerokość tabeli. |
height | Number | Minimalna wysokość tabeli. Rzeczywista wysokość wyrenderowanej tabeli zależy od czynników takich jak rozmiar czcionki tekstu. |
Zwróć
Table
– wstawiona tabela.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(table)
Wstawia na stronie kopię podanego Table
.
Pozycja 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 dziedziczone z poziomu strony głównej lub układu też dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone z stron nadrzędnych lub układów są kopiowane do elementu 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. |
Zwróć
Table
– wstawiona tabela.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 jest wstawiany w domyślnym 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, który powinien zawierać kształt pola tekstowego. |
Zwróć
Shape
– kształt pola tekstowego.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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, który powinien zawierać kształt pola tekstowego. |
left | Number | Pozioma lokalizacja kształtu pola tekstowego, mierzona od lewego górnego rogu strony. |
top | Number | Pozycja pionowa pola tekstowego mierzona od lewego górnego rogu strony. |
width | Number | Szerokość kształtu pola tekstowego. |
height | Number | Wysokość kształtu pola tekstowego. |
Zwróć
Shape
– kształt pola tekstowego.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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. |
Zwróć
Video
– wstawiony film.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 o 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 | Pozycja pozioma filmu w punktach, mierzona od lewego górnego rogu strony. |
top | Number | Położenie filmu w pionie określone w punktach, mierzone w lewym górnym rogu strony. |
width | Number | Szerokość filmu w punktach. |
height | Number | Wysokość filmu w punktach. |
Zwróć
Video
– wstawiony film.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(video)
Wstawia na stronie kopię podanego Video
.
Pozycja 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 dziedziczone z poziomu strony głównej lub układu też dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone z stron nadrzędnych lub układów są kopiowane do elementu 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ć. |
Zwróć
Video
– wstawiony film.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertWordArt(wordArt)
Wstawia na stronie kopię podanego WordArt
.
Pozycja 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 dziedziczone z poziomu strony głównej lub układu też dziedziczą ze wstawionego elementu.
Jeśli podany element jest symbolem zastępczym kopiowanym z innej prezentacji, właściwości dziedziczone z stron nadrzędnych lub układów są kopiowane do elementu 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, którą chcesz skopiować i wstawić. |
Zwróć
WordArt
– wstawiono obiekt WordArt.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Usuwa stronę.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText)
Zamienia wszystkie wystąpienia tekstu pasującego do tekstu na tekst zastępczy. Wielkość liter nie jest rozróżniana.
Parametry
Nazwa | Typ | Opis |
---|---|---|
findText | String | Tekst do znalezienia. |
replaceText | String | Tekst zastępujący dopasowany tekst. |
Zwróć
Integer
– liczba zmienionych wystąpień.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
Zamienia wszystkie wystąpienia tekstu pasującego do tekstu na tekst zastępczy.
Parametry
Nazwa | Typ | Opis |
---|---|---|
findText | String | Tekst do znalezienia. |
replaceText | String | Tekst zastępujący dopasowany tekst. |
matchCase | Boolean | Jeśli zasada true , wielkość liter w wyszukiwaniu ma znaczenie, a false ma znaczenie. |
Zwróć
Integer
– liczba zmienionych wystąpień.
Upoważnienie
Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
selectAsCurrentPage()
Zaznacza element Page
w aktywnej prezentacji jako current page selection
i usuwa wcześniejszy wybór.
Skrypt ma dostęp tylko do użytkownika, który go uruchomi, i tylko wtedy, gdy jest on 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, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations