Class Layout

Układ

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

MetodaZwracany typKrótki opis
getBackground()PageBackgroundPobiera tło strony.
getColorScheme()ColorSchemePobiera ColorScheme powiązany ze stroną.
getGroups()Group[]Zwraca listę obiektów Group na stronie.
getImages()Image[]Zwraca listę obiektów Image na stronie.
getLayoutName()StringPobiera nazwę układu.
getLines()Line[]Zwraca listę obiektów Line na stronie.
getMaster()MasterPobiera element główny, na którym jest oparty układ.
getObjectId()StringPobiera unikalny identyfikator strony.
getPageElementById(id)PageElementZwraca PageElement na stronie o podanym identyfikatorze lub null, jeśli żadna nie istnieje.
getPageElements()PageElement[]Zwraca listę obiektów PageElement wyrenderowanych na stronie.
getPageType()PageTypePobiera typ strony.
getPlaceholder(placeholderType)PageElementZwraca obiekt zastępnik PageElement dla określonego elementu PlaceholderType lub null, jeśli nie ma pasującego elementu zastępczego.
getPlaceholder(placeholderType, placeholderIndex)PageElementZwraca obiekt zastępnik PageElement dla określonego PlaceholderType i indeksu zastępnika lub null, jeśli zastępnik jest nieobecny.
getPlaceholders()PageElement[]Zwraca listę obiektów zastępczych 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)GroupGrupuje wszystkie określone elementy strony.
insertGroup(group)GroupWstawia na stronie kopię podanego elementu Group.
insertImage(blobSource)ImageWstawia obraz w lewym górnym rogu strony w domyślnym rozmiarze z określonego pliku blob obrazu.
insertImage(blobSource, left, top, width, height)ImageWstawia na stronie obraz z określonego obiektu blob obrazu o podanej pozycji i rozmiarze.
insertImage(image)ImageWstawia na stronie kopię podanego elementu Image.
insertImage(imageUrl)ImageWstawia obraz w lewym górnym rogu strony w domyślnym rozmiarze z podanego adresu URL.
insertImage(imageUrl, left, top, width, height)ImageWstawia obraz na stronie w określonej pozycji i rozmiarze z podanego adresu URL.
insertLine(line)LineWstawia na stronie kopię podanego elementu Line.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineWstawia na stronie linię łączącą 2 connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)LineWstawia linię na stronie.
insertPageElement(pageElement)PageElementWstawia na stronie kopię podanego elementu PageElement.
insertShape(shape)ShapeWstawia na stronie kopię podanego elementu Shape.
insertShape(shapeType)ShapeWstawia kształt na stronie.
insertShape(shapeType, left, top, width, height)ShapeWstawia kształt na stronie.
insertSheetsChart(sourceChart)SheetsChartWstawia na stronie wykres z Arkuszy Google.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartWstawia wykres arkuszy Google na stronie w podanym położeniu i rozmiarze.
insertSheetsChart(sheetsChart)SheetsChartWstawia na stronie kopię podanego elementu SheetsChart.
insertSheetsChartAsImage(sourceChart)ImageWstawia wykres z Arkuszy Google jako Image na stronie.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageWstawia wykres z Arkuszy Google jako element Image na stronie w wybranej pozycji i rozmiarze.
insertTable(numRows, numColumns)TableWstawia tabelę na stronie.
insertTable(numRows, numColumns, left, top, width, height)TableWstawia tabelę na stronie w podanym położeniu i rozmiarze.
insertTable(table)TableWstawia na stronie kopię podanego elementu Table.
insertTextBox(text)ShapeWstawia na stronie pole tekstowe Shape zawierające podany ciąg znaków.
insertTextBox(text, left, top, width, height)ShapeWstawia na stronie pole tekstowe Shape zawierające podany ciąg znaków.
insertVideo(videoUrl)VideoWstawia film w lewym górnym rogu strony w domyślnym rozmiarze.
insertVideo(videoUrl, left, top, width, height)VideoWstawia film na stronie w określonej pozycji i rozmiarze.
insertVideo(video)VideoWstawia na stronie kopię podanego elementu Video.
insertWordArt(wordArt)WordArtWstawia na stronie kopię podanego elementu WordArt.
remove()voidUsuwa stronę.
replaceAllText(findText, replaceText)IntegerZastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia.
replaceAllText(findText, replaceText, matchCase)IntegerZastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia.
selectAsCurrentPage()voidWybiera Page w aktywnej prezentacji jako current page selection i usuwa poprzednią selekcję.

Szczegółowa dokumentacja

getBackground()

Pobiera tło strony.

Powrót

PageBackground – 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

getColorScheme()

Pobiera ColorScheme powiązany ze stroną.

Powrót

ColorScheme – 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

getGroups()

Zwraca listę obiektów Group na stronie.

Powrót

Group[]

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

getImages()

Zwraca listę obiektów Image na stronie.

Powrót

Image[]

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

getLayoutName()

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

getLines()

Zwraca listę obiektów Line na stronie.

Powrót

Line[]

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

getMaster()

Pobiera element główny, na którym jest oparty układ.

Powrót

Master

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

getObjectId()

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

getPageElementById(id)

Zwraca PageElement na stronie o podanym identyfikatorze lub null, jeśli żadna nie istnieje.

Parametry

NazwaTypOpis
idStringIdentyfikator elementu strony, który jest pobierany.

Powrót

PageElement – 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

getPageElements()

Zwraca listę obiektów PageElement wyrenderowanych na stronie.

Powrót

PageElement[]

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

getPageType()

Pobiera typ strony.

Powrót

PageType – typ 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

getPlaceholder(placeholderType)

Zwraca obiekt zastępnik PageElement dla określonego elementu PlaceholderType 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

NazwaTypOpis
placeholderTypePlaceholderType

Powrót

PageElement

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

getPlaceholder(placeholderType, placeholderIndex)

Zwraca obiekt zastępnik PageElement dla określonego PlaceholderType 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

NazwaTypOpis
placeholderTypePlaceholderType
placeholderIndexInteger

Powrót

PageElement

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

getPlaceholders()

Zwraca listę obiektów zastępczych PageElement na stronie.

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

Powrót

PageElement[]

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

getShapes()

Zwraca listę obiektów Shape na stronie.

Powrót

Shape[]

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

getSheetsCharts()

Zwraca listę obiektów SheetsChart na stronie.

Powrót

SheetsChart[]

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

getTables()

Zwraca listę obiektów Table na stronie.

Powrót

Table[]

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

getVideos()

Zwraca listę obiektów Video na stronie.

Powrót

Video[]

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

getWordArts()

Zwraca listę obiektów WordArt na stronie.

Powrót

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

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, Tablesplaceholder Shapes, nie można grupować.

Parametry

NazwaTypOpis
pageElementsPageElement[]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

insertGroup(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

NazwaTypOpis
groupGroupGrupa, 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

insertImage(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 BlobSource, 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

NazwaTypOpis
blobSourceBlobSourceDane 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

insertImage(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 BlobSource 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

NazwaTypOpis
blobSourceBlobSourceDane obrazu.
leftNumberPozycja pozioma obrazu w punktach, mierzona od lewego górnego rogu strony.
topNumberPozycja pionowa obrazu w punktach, mierzona od lewego górnego rogu strony.
widthNumberSzerokość obrazu w punktach.
heightNumberWysokość 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

insertImage(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

NazwaTypOpis
imageImageObraz, 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

insertImage(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

NazwaTypOpis
imageUrlStringAdres 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

insertImage(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

NazwaTypOpis
imageUrlStringAdres URL obrazu.
leftNumberPozycja pozioma obrazu w punktach, mierzona od lewego górnego rogu strony.
topNumberPozycja pionowa obrazu w punktach, mierzona od lewego górnego rogu strony.
widthNumberSzerokość obrazu w punktach.
heightNumberWysokość 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

insertLine(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

NazwaTypOpis
lineLinewiersz 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

insertLine(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

NazwaTypOpis
lineCategoryLineCategoryKategoria linii do wstawienia.
startConnectionSiteConnectionSiteMiejsce połączenia, w którym ma być połączony początek linii.
endConnectionSiteConnectionSiteMiejsce 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

insertLine(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

NazwaTypOpis
lineCategoryLineCategoryKategoria linii do wstawienia.
startLeftNumberPozycja pozioma punktu początkowego linii, mierzona w punktach od lewego górnego rogu strony.
startTopNumberPozycja pionowa punktu początkowego linii, mierzona w punktach od lewego górnego rogu strony.
endLeftNumberPozycja pozioma punktu końcowego linii, mierzona w punktach od lewego górnego rogu strony.
endTopNumberPozycja 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

insertPageElement(pageElement)

Wstawia na stronie kopię podanego elementu PageElement.

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

NazwaTypOpis
pageElementPageElementElement strony, który ma zostać skopiowany i wklejony.

Powrót

PageElement – 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

insertShape(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

NazwaTypOpis
shapeShapeKształ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

insertShape(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

NazwaTypOpis
shapeTypeShapeTypeTyp 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

insertShape(shapeType, left, top, width, height)

Wstawia kształt na stronie.

Parametry

NazwaTypOpis
shapeTypeShapeTypeTyp kształtu do wstawienia.
leftNumberPozycja pozioma kształtu, mierzona od lewego górnego rogu strony.
topNumberPozycja pionowa kształtu, mierzona od lewego górnego rogu strony.
widthNumberSzerokość kształtu.
heightNumberWysokość 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

insertSheetsChart(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

NazwaTypOpis
sourceChartEmbeddedChartwykres w arkuszu kalkulacyjnym, który chcesz wstawić na stronie;

Powrót

SheetsChart – 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

insertSheetsChart(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

NazwaTypOpis
sourceChartEmbeddedChartwykres w arkuszu kalkulacyjnym, który chcesz wstawić na stronie;
leftNumberPozycja pozioma wykresu w punktach, mierzona od lewego górnego rogu strony.
topNumberPozycja pionowa wykresu w punktach, mierzona od lewego górnego rogu strony.
widthNumberSzerokość wykresu w punktach.
heightNumberWysokość wykresu w punktach.

Powrót

SheetsChart – 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

insertSheetsChart(sheetsChart)

Wstawia na stronie kopię podanego elementu SheetsChart.

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

NazwaTypOpis
sheetsChartSheetsChartwykres arkuszy do skopiowania i wstawienia.

Powrót

SheetsChart – 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

insertSheetsChartAsImage(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

NazwaTypOpis
sourceChartEmbeddedChartwykres 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

insertSheetsChartAsImage(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

NazwaTypOpis
sourceChartEmbeddedChartwykres w arkuszu kalkulacyjnym, który chcesz wstawić na stronie;
leftNumberPozycja pozioma wykresu w punktach, mierzona od lewego górnego rogu strony.
topNumberPozycja pionowa wykresu w punktach, mierzona od lewego górnego rogu strony.
widthNumberSzerokość wykresu w punktach.
heightNumberWysokość 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

insertTable(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

NazwaTypOpis
numRowsIntegerLiczba wierszy w tabeli.
numColumnsIntegerLiczba 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

insertTable(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

NazwaTypOpis
numRowsIntegerLiczba wierszy w tabeli.
numColumnsIntegerLiczba kolumn w tabeli.
leftNumberPozycja pozioma tabeli mierzona od lewego górnego rogu strony.
topNumberPozycja pionowa tabeli mierzona od lewego górnego rogu strony.
widthNumberSzerokość tabeli.
heightNumberMinimalna 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

insertTable(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

NazwaTypOpis
tableTableTabela 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

insertTextBox(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

NazwaTypOpis
textStringCią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

insertTextBox(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

NazwaTypOpis
textStringCiąg tekstowy, który powinno zawierać pole tekstowe.
leftNumberPozycja pozioma kształtu pola tekstowego mierzona od lewego górnego rogu strony.
topNumberPozycja pionowa kształtu pola tekstowego, mierzona od lewego górnego rogu strony.
widthNumberSzerokość kształtu pola tekstowego.
heightNumberWysokość 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

insertVideo(videoUrl)

Wstawia film w lewym górnym rogu strony w domyślnym rozmiarze.

Obecnie obsługiwane są tylko filmy z YouTube.

Parametry

NazwaTypOpis
videoUrlStringAdres 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

insertVideo(videoUrl, left, top, width, height)

Wstawia film na stronie w określonej pozycji i rozmiarze.

Obecnie obsługiwane są tylko filmy z YouTube.

Parametry

NazwaTypOpis
videoUrlStringAdres URL filmu, który chcesz wstawić.
leftNumberPozycja pozioma filmu w punktach, mierzona od lewego górnego rogu strony.
topNumberPozycja pionowa filmu w punktach, mierzona od lewego górnego rogu strony.
widthNumberSzerokość filmu w punktach.
heightNumberWysokość 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

insertVideo(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

NazwaTypOpis
videoVideoFilm, 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

insertWordArt(wordArt)

Wstawia na stronie kopię podanego elementu WordArt.

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

NazwaTypOpis
wordArtWordArtGrupa, która ma zostać skopiowana i wstawiona.

Powrót

WordArt – 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

replaceAllText(findText, replaceText)

Zastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia. Wielkość liter nie ma znaczenia.

Parametry

NazwaTypOpis
findTextStringTekst do znalezienia.
replaceTextStringTekst, 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

replaceAllText(findText, replaceText, matchCase)

Zastępuje wszystkie wystąpienia tekstu pasującego do tekstu do znalezienia tekstem do zastąpienia.

Parametry

NazwaTypOpis
findTextStringTekst do znalezienia.
replaceTextStringTekst, który ma zastąpić dopasowany tekst.
matchCaseBooleanJeś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

selectAsCurrentPage()

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