PageElement
przedstawiający obraz.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
alignOnPage(alignmentPosition) | Image | Wyrównuje element do określonej pozycji wyrównania na stronie. |
bringForward() | Image | Przesuwa element o jeden element w górę. |
bringToFront() | Image | Przesuwa element na wierzch strony. |
duplicate() | PageElement | Zduplikuje element strony. |
getAs(contentType) | Blob | Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści. |
getBlob() | Blob | Zwraca dane z tego obrazu jako obiekt blob. |
getBorder() | Border | Zwraca Border obrazu. |
getConnectionSites() | ConnectionSite[] | Zwraca listę ConnectionSite w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn połączenia. |
getContentUrl() | String | Pobiera adres URL obrazu. |
getDescription() | String | Zwraca opis tekstu alternatywnego elementu strony. |
getHeight() | Number | Pobiera wysokość elementu w punktach, czyli wysokość jego prostokąta ograniczającego, gdy nie jest on obracany. |
getInherentHeight() | Number | Zwraca wbudowaną wysokość elementu w punktach. |
getInherentWidth() | Number | Zwraca wbudowaną szerokość elementu w punktach. |
getLeft() | Number | Zwraca poziomą pozycję elementu w punktach, mierząc od lewego górnego rogu strony, gdy element nie jest obracany. |
getLink() | Link | Zwraca wartość Link lub null , jeśli nie ma linku. |
getObjectId() | String | Zwraca unikalny identyfikator tego obiektu. |
getPageElementType() | PageElementType | Zwraca typ elementu strony jako typ enumeracji PageElementType . |
getParentGroup() | Group | Zwraca grupę, do której należy ten element strony, lub null , jeśli element nie należy do żadnej grupy. |
getParentPage() | Page | Zwraca stronę, na której znajduje się element strony. |
getParentPlaceholder() | PageElement | Zwraca element strony nadrzędnej miejsca zarezerwowanego. |
getPlaceholderIndex() | Integer | Zwraca indeks obrazu zastępczego. |
getPlaceholderType() | PlaceholderType | Zwraca typ symbolu zastępczego obrazu lub PlaceholderType.NONE , jeśli kształt nie jest symbolem zastępczym. |
getRotation() | Number | Zwraca kąt obrotu elementu wokół jego środka w stopniach, przy czym 0 stopni oznacza brak obrotu. |
getSourceUrl() | String | Pobiera adres URL źródła obrazu, jeśli jest dostępny. |
getTitle() | String | Zwraca tytuł tekstu alternatywnego elementu strony. |
getTop() | Number | Pobiera pionowe położenie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany. |
getTransform() | AffineTransform | Zwraca transformację elementu strony. |
getWidth() | Number | Zwraca szerokość elementu w punktach, czyli szerokość jego prostokąta ograniczającego, gdy element nie jest obrócony. |
preconcatenateTransform(transform) | Image | Przekształca podany obiekt transformacji w istniejącą transformację elementu strony. |
remove() | void | Usuwa element strony. |
removeLink() | void | Usuwa Link . |
replace(blobSource) | Image | Zastępuje ten obraz obrazem opisanym przez obiekt BlobSource . |
replace(blobSource, crop) | Image | Zastępuje ten obraz obrazem opisanym przez obiekt Image , opcjonalnie przycinając obraz, aby pasował do wymiarów. |
replace(imageUrl) | Image | Zastępuje ten obraz innym obrazem pobranym z podanego adresu URL. |
replace(imageUrl, crop) | Image | Zastępuje ten obraz innym obrazem pobranym z podanego adresu URL, opcjonalnie przycinając go do wymiarów. |
scaleHeight(ratio) | Image | Skaluje wysokość elementu zgodnie z określonym współczynnikiem. |
scaleWidth(ratio) | Image | Skaluje szerokość elementu zgodnie z określonym współczynnikiem. |
select() | void | Wybiera tylko PageElement w aktywnej prezentacji i usuwa wszystkie poprzednie zaznaczenia. |
select(replace) | void | Wybiera PageElement w aktywnej prezentacji. |
sendBackward() | Image | Przesuwa element strony o jeden element wstecz. |
sendToBack() | Image | Przesuwa element na końcu strony. |
setDescription(description) | Image | Ustawia tekst alternatywny elementu strony. |
setHeight(height) | Image | Ustawia wysokość elementu w punktach, czyli wysokość jego prostokąta ograniczającego, gdy nie jest on obracany. |
setLeft(left) | Image | Ustawia położenie elementu w osi poziomej w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany. |
setLinkSlide(slideIndex) | Link | Przypisuje wartość Link do podanego parametru Slide , używając indeksu liczonego od 0. |
setLinkSlide(slide) | Link | Ustawia Link na podanym Slide , a link jest ustawiany za pomocą podanego identyfikatora slajdu. |
setLinkSlide(slidePosition) | Link | Ustawia Link na podanej wartości Slide , używając względnego położenia slajdu. |
setLinkUrl(url) | Link | Ustawia Link na podany niepusty ciąg znaków adresu URL. |
setRotation(angle) | Image | Ustawia kąt obrotu elementu wokół jego środka zgodnie z ruchem wskazówek zegara w stopniach. |
setTitle(title) | Image | Ustawia tytuł tekstu alternatywnego elementu strony. |
setTop(top) | Image | Ustawia położenie pionowe elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany. |
setTransform(transform) | Image | Ustawia przekształcenie elementu strony za pomocą podanego przekształcenia. |
setWidth(width) | Image | Ustawia szerokość elementu w punktach, czyli szerokość jego prostokąta ograniczającego, gdy nie jest on obracany. |
Szczegółowa dokumentacja
alignOnPage(alignmentPosition)
Wyrównuje element do określonej pozycji wyrównania na stronie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
alignmentPosition | AlignmentPosition | Pozycja, w której ma być wyrównany ten element strony. |
Powrót
Image
– ten element strony, do łańcuchowania.
bringForward()
Przesuwa element o jeden element w górę.
Element strony nie może być w grupie.
Powrót
Image
– ten element strony, do łańcuchowania.
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
bringToFront()
Przesuwa element na wierzch strony.
Element strony nie może być w grupie.
Powrót
Image
– ten element strony, do łańcuchowania.
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
duplicate()
Zduplikuje element strony.
Zduplikowany element strony jest umieszczany na tej samej stronie i w tej samej pozycji co element oryginalny.
Powrót
PageElement
– nowy duplikat tego elementu 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
getAs(contentType)
Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „mójplik.pdf”. Zakłada ona jednak, że część nazwy pliku, która następuje po ostatnim okresie (jeśli w ogóle występuje), to istniejące rozszerzenie, które należy zastąpić. W rezultacie plik „ShoppingList.12.25.2014” zmieni nazwę na „ShoppingList.12.25.pdf”.
Informacje o limitach dziennych konwersji znajdziesz w artykule Limity dotyczące usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Typ MIME, na który ma nastąpić konwersja. W przypadku większości blobów opcja 'application/pdf' jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są również wartości 'image/bmp' , 'image/gif' , 'image/jpeg' lub 'image/png' . W przypadku dokumentu w Dokumentach Google możesz też użyć 'text/markdown' . |
Powrót
Blob
– dane w postaci bloba.
getBlob()
getBorder()
getConnectionSites()
Zwraca listę ConnectionSite
w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn połączenia.
Powrót
ConnectionSite[]
– lista witryn połączenia, która może być pusta, jeśli ten element nie ma żadnych witryn połączenia.
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
getContentUrl()
Pobiera adres URL obrazu.
Ten adres URL jest oznaczony tagiem konta osoby, która wysłała prośbę, więc każda osoba, która ma ten adres URL, uzyskuje dostęp do obrazu jako pierwotny żądający. Jeśli ustawienia udostępniania prezentacji ulegną zmianie, możesz utracić dostęp do obrazu. Zwrócony adres URL wygasa po krótkim czasie.
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
getDescription()
Zwraca opis tekstu alternatywnego elementu strony. Opis jest łączony z tytułem, aby wyświetlać i czytać tekst alternatywny.
Powrót
String
– opis tekstu alternatywnego elementu 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
getHeight()
Pobiera wysokość elementu w punktach, czyli wysokość jego prostokąta ograniczającego, gdy nie jest on obracany.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony nie są zgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i umieszczenia.
Powrót
Number
– Właściwa wysokość elementu strony w punktach lub null
, jeśli element strony nie ma wysokości.
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
getInherentHeight()
Zwraca wbudowaną wysokość elementu w punktach.
Przekształcenie elementu strony jest względne względem jego rzeczywistego rozmiaru. Użyj rozmiaru elementu w połączeniu z jego przekształceniem, aby określić jego ostateczny wygląd.
Powrót
Number
– Właściwa wysokość elementu strony w punktach lub null
, jeśli element strony nie ma wysokości.
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
getInherentWidth()
Zwraca wbudowaną szerokość elementu w punktach.
Przekształcenie elementu strony jest względne względem jego rzeczywistego rozmiaru. Użyj rozmiaru elementu w połączeniu z jego przekształceniem, aby określić jego ostateczny wygląd.
Powrót
Number
– Właściwa szerokość elementu strony w punktach lub null
, jeśli element strony nie ma szerokości.
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
getLeft()
Zwraca poziomą pozycję elementu w punktach, mierząc od lewego górnego rogu strony, gdy element nie jest obracany.
Powrót
Number
– poziome położenie tego elementu w punktach, licząc od lewego górnego rogu 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
getLink()
Zwraca wartość Link
lub null
, jeśli nie ma linku.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const link = shape.getLink(); if (link != null) { Logger.log(`Shape has a link of type: ${link.getLinkType()}`); }
Powrót
Link
– Link
lub null
, jeśli nie ma połączenia.
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()
Zwraca unikalny identyfikator tego obiektu. Identyfikatory obiektów używane przez strony i elementy stron należą do tej samej przestrzeni nazw.
Powrót
String
– niepowtarzalny identyfikator tego obiektu.
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
getPageElementType()
Zwraca typ elementu strony jako typ enumeracji PageElementType
.
Powrót
PageElementType
– typ elementu 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
getParentGroup()
Zwraca grupę, do której należy ten element strony, lub null
, jeśli element nie należy do żadnej grupy.
Powrót
Group
– grupa, do której należy ten element strony, lub null
.
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
getParentPage()
Zwraca stronę, na której znajduje się element strony.
Powrót
Page
– strona, na której znajduje się element.
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
getParentPlaceholder()
Zwraca element strony nadrzędnej elementu zastępczego. Zwraca wartość null
, jeśli obraz nie jest placeholderem lub nie ma elementu nadrzędnego.
Powrót
PageElement
– element strony nadrzędnej tego elementu zastępczego obrazu lub null
, jeśli obraz nie jest zastępczym lub nie ma elementu nadrzędnego.
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
getPlaceholderIndex()
Zwraca indeks obrazu zastępczego. Jeśli co najmniej 2 obrazy zastępcze na tej samej stronie są tego samego typu, każdy z nich ma unikalną wartość indeksu. Zwraca wartość null
, jeśli obraz nie jest obiektem zastępczym.
Powrót
Integer
– indeks zastępczego obrazu lub null
, jeśli obraz nie jest zastępczy.
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
getPlaceholderType()
Zwraca typ symbolu zastępczego obrazu lub PlaceholderType.NONE
, jeśli kształt nie jest symbolem zastępczym.
Powrót
PlaceholderType
– typ obiektu zastępczego tego obrazu.
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
getRotation()
Zwraca kąt obrotu elementu wokół jego środka w stopniach, przy czym 0 stopni oznacza brak obrotu.
Powrót
Number
– kąt obrotu wyrażony w stopniach w zakresie od 0 (włącznie) do 360 (wyłącznie).
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
getSourceUrl()
Pobiera adres URL źródła obrazu, jeśli jest dostępny.
Gdy obraz jest wstawiany z adresu URL, zwraca adres URL podany podczas wstawiania obrazu.
Powrót
String
– adres URL obrazu lub null
, jeśli obraz nie ma adresu URL źródła.
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
getTitle()
Zwraca tytuł tekstu alternatywnego elementu strony. Tytuł jest połączony z opisem, aby wyświetlać i odczytywać tekst alternatywny.
Powrót
String
– tytuł tekstu alternatywnego elementu 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
getTop()
Pobiera pionowe położenie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.
Powrót
Number
– pionowe położenie tego elementu w punktach, licząc od lewego górnego rogu 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
getTransform()
Zwraca transformację elementu strony.
Wizualny wygląd elementu strony jest określany przez jego bezwzględną transformację. Aby obliczyć transformację bezwzględną, złącz uprzednio transformację elementu strony z transformacjami wszystkich jego grup nadrzędnych. Jeśli element strony nie znajduje się w grupie, jego transformacja bezwzględna jest taka sama jak wartość w tym polu.
Powrót
AffineTransform
– transformacja elementu 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
getWidth()
Zwraca szerokość elementu w punktach, czyli szerokość jego prostokąta ograniczającego, gdy element nie jest obrócony.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony nie są zgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i umieszczenia.
Powrót
Number
– Właściwa szerokość elementu strony w punktach lub null
, jeśli element strony nie ma szerokości.
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
preconcatenateTransform(transform)
Przekształca podany obiekt transformacji w istniejącą transformację elementu strony.
newTransform = argument * existingTransform;
Aby na przykład przesunąć element strony o 36 punktów w lewo:
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
Możesz też zastąpić transformację elementu strony wartością setTransform(transform)
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
transform | AffineTransform | Transformacja do wstępnego konkatenowania na potrzeby transformacji tego elementu strony. |
Powrót
Image
– ten element strony, do łańcuchowania.
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 element strony.
Jeśli po operacji usuwania element Group
zawiera tylko jeden element strony lub nie zawiera żadnego, sama grupa również zostanie usunięta.
Jeśli w masterze lub szablonie usuniesz element zastępczy PageElement
, zostaną też usunięte wszystkie puste elementy zastępcze, które go dziedziczyły.
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
removeLink()
Usuwa Link
.
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
replace(blobSource)
Zastępuje ten obraz obrazem opisanym przez obiekt BlobSource
.
Wstawianie obrazu powoduje jego pobieranie z
BlobSource
, 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 względem rozmiaru istniejącego obrazu.
const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. const driveImage = DriveApp.getFileById("123abc"); image.replace(driveImage);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Dane obrazu. |
Powrót
Image
– ta Image
po wymianie.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(blobSource, crop)
Zastępuje ten obraz obrazem opisanym przez obiekt Image
, opcjonalnie przycinając obraz, aby pasował do wymiarów.
Wstawianie obrazu powoduje jego pobranie z
BlobSource
, 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.
const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. const driveImage = DriveApp.getFileById('123abc'); // Replace and crop the drive image. image.replace(driveImage, true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Dane obrazu. |
crop | Boolean | Jeśli true , obraz zostanie przycięty tak, aby pasował do rozmiaru istniejącego obrazu. W przeciwnym razie obraz zostanie przeskalowany i wyśrodkowany. |
Powrót
Image
– ta Image
po wymianie.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl)
Zastępuje ten obraz innym obrazem pobranym 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ą mieć więcej niż 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ą getSourceUrl()
.
Aby zachować format obrazu, obraz jest skalowany i wyśrodkowywany względem rozmiaru istniejącego obrazu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL, z którego można pobrać obraz. |
Powrót
Image
– ta Image
po wymianie.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl, crop)
Zastępuje ten obraz innym obrazem pobranym z podanego adresu URL, opcjonalnie przycinając go do wymiarów.
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 nie może być dłuższy niż 2 kB.
Parametry
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL, z którego można pobrać obraz. |
crop | Boolean | Jeśli true , obraz zostaje przycięty, aby pasował do rozmiaru istniejącego obrazu. W przeciwnym razie obraz zostanie przeskalowany i wyśrodkowany. |
Powrót
Image
– ta Image
po wymianie.
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
scaleHeight(ratio)
Skaluje wysokość elementu zgodnie z określonym współczynnikiem. Wysokość elementu to wysokość jego ogranicznika, gdy element nie jest obracany.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony nie są zgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i umieszczenia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
ratio | Number | Współczynnik, o który należy pomnożyć wysokość tego elementu strony. |
Powrót
Image
– ten element strony, do łańcuchowania.
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
scaleWidth(ratio)
Skaluje szerokość elementu zgodnie z określonym współczynnikiem. Szerokość elementu to szerokość jego ogranicznika, gdy element nie jest obracany.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony nie są zgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i umieszczenia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
ratio | Number | Współczynnik, o który należy pomnożyć szerokość tego elementu strony. |
Powrót
Image
– ten element strony, do łańcuchowania.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Wybiera tylko PageElement
w aktywnej prezentacji i usuwa wszystkie poprzednie zaznaczenia. To samo co wywołanie funkcji select(replace)
z argumentem true
.
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ą.
Spowoduje to ustawienie nadrzędnego Page
PageElement
jako current page selection
.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
Wybiera PageElement
w aktywnej prezentacji.
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ą.
Przekaż zmienną true
do tej metody, aby wybrać tylko PageElement
i usunąć poprzednie zaznaczenie. W ten sposób ustawiasz też element nadrzędny Page
elementu PageElement
jako current page selection
.
Przekaz false
, aby wybrać wiele obiektów PageElement
. Obiekty PageElement
muszą znajdować się w tym samym Page
.
Podczas wybierania elementu strony za pomocą parametru false
należy spełnić te warunki:
- Obiekt nadrzędny
Page
obiektuPageElement
musi być obiektemcurrent page selection
. - Nie powinno być wybranych kilku obiektów
Page
.
Aby mieć pewność, że tak jest, najlepiej najpierw wybrać element nadrzędny Page
za pomocą elementu Page.selectAsCurrentPage()
, a potem wybrać elementy strony na tej stronie.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // First select the slide page, as the current page selection. slide.selectAsCurrentPage(); // Then select all the page elements in the selected slide page. const pageElements = slide.getPageElements(); for (let i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
replace | Boolean | Jeśli zaznaczone jest true , wybór zastępuje wszystkie poprzednie; w przeciwnym razie dodawany jest do poprzedniego. |
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
sendBackward()
Przesuwa element strony o jeden element wstecz.
Element strony nie może być w grupie.
Powrót
Image
– ten element strony, do łańcuchowania.
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
sendToBack()
Przesuwa element na końcu strony.
Element strony nie może być w grupie.
Powrót
Image
– ten element strony, do łańcuchowania.
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
setDescription(description)
Ustawia tekst alternatywny elementu strony.
Ta metoda nie jest obsługiwana w przypadku elementów Group
.
// Set the first page element's alt text description to "new alt text // description". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
Parametry
Nazwa | Typ | Opis |
---|---|---|
description | String | Ciąg tekstowy, w którym ma być ustawiony tekst alternatywny. |
Powrót
Image
– ten 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
setHeight(height)
Ustawia wysokość elementu w punktach, czyli wysokość jego prostokąta ograniczającego, gdy nie jest on obracany.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony nie są zgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i umieszczenia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
height | Number | Nowa wysokość tego elementu strony do ustawienia w punktach. |
Powrót
Image
– ten element strony, do łańcuchowania.
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
setLeft(left)
Ustawia położenie elementu w osi poziomej w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.
Parametry
Nazwa | Typ | Opis |
---|---|---|
left | Number | Nowa pozycja pozioma do ustawienia w punktach. |
Powrót
Image
– ten element strony, do łańcuchowania.
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
setLinkSlide(slideIndex)
Przypisuje wartość Link
do podanego parametru Slide
, używając indeksu liczonego od 0.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(0);
Parametry
Nazwa | Typ | Opis |
---|---|---|
slideIndex | Integer | Indeks slajdów liczony od zera. |
Powrót
Link
– ustawiona wartość Link
.
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
setLinkSlide(slide)
Ustawia Link
na podanym Slide
, a link jest ustawiany za pomocą podanego identyfikatora slajdu.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(slides[0]);
Parametry
Nazwa | Typ | Opis |
---|---|---|
slide | Slide | Slide , które mają być połączone. |
Powrót
Link
– ustawiona wartość Link
.
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
setLinkSlide(slidePosition)
Ustawia Link
na podanej wartości Slide
, używając względnego położenia slajdu.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Parametry
Nazwa | Typ | Opis |
---|---|---|
slidePosition | SlidePosition | Względne SlidePosition . |
Powrót
Link
– ustawiona wartość Link
.
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
setLinkUrl(url)
Ustawia Link
na podany niepusty ciąg znaków adresu URL.
// Set a link to the URL. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkUrl('https://slides.google.com');
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL. |
Powrót
Link
– ustawiona wartość Link
.
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
setRotation(angle)
Ustawia kąt obrotu elementu wokół jego środka zgodnie z ruchem wskazówek zegara w stopniach.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony nie są zgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i umieszczenia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
angle | Number | Nowy kąt obrotu zgodnie z ruchem wskazówek zegara do ustawienia w stopniach. |
Powrót
Image
– ten element strony, do łańcuchowania.
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
setTitle(title)
Ustawia tytuł tekstu alternatywnego elementu strony.
Ta metoda nie jest obsługiwana w przypadku elementów Group
.
// Set the first page element's alt text title to "new alt text title". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Ciąg tekstowy, w którym ma być ustawiony tytuł tekstu alternatywnego. |
Powrót
Image
– ten 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
setTop(top)
Ustawia położenie pionowe elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.
Parametry
Nazwa | Typ | Opis |
---|---|---|
top | Number | Nowa pozycja pionowa do ustawienia w punktach. |
Powrót
Image
– ten element strony, do łańcuchowania.
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
setTransform(transform)
Ustawia przekształcenie elementu strony za pomocą podanego przekształcenia.
Zmiana transformacji grupy zmienia bezwzględną transformację elementów strony w tej grupie, co może zmienić ich wygląd.
Zmiana transformacji elementu strony, który jest w grupie, zmienia tylko transformację tego elementu. Nie wpływa na transformacje grupy ani innych elementów strony w grupie.
Szczegółowe informacje o tym, jak transformacje wpływają na wygląd elementów strony, znajdziesz w artykule getTransform()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
transform | AffineTransform | Transformacja ustawiona dla tego elementu strony. |
Powrót
Image
– ten element do łańcucha.
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
setWidth(width)
Ustawia szerokość elementu w punktach, czyli szerokość jego prostokąta ograniczającego, gdy nie jest on obracany.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony nie są zgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i umieszczenia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
width | Number | Nowa szerokość tego elementu strony do ustawienia w punktach. |
Powrót
Image
– ten element strony, do łańcuchowania.
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