Element PageElement
reprezentujący obraz.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
alignOnPage(alignmentPosition) | Image | Wyrównuje element do określonego położenia wyrównania na stronie. |
bringForward() | Image | Przesuwa element strony o jeden element do przodu. |
bringToFront() | Image | Przenosi element strony na początek. |
duplicate() | PageElement | Powiela element strony. |
getAs(contentType) | Blob | Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. |
getBlob() | Blob | Zwraca dane wewnątrz obrazu jako obiekt blob. |
getBorder() | Border | Zwraca Border obrazu. |
getConnectionSites() | ConnectionSite[] | Zwraca listę elementów ConnectionSite w elemencie strony lub pustą listę, jeśli strona
z elementem nie ma żadnych połączonych stron. |
getContentUrl() | String | Pobiera adres URL obrazu. |
getDescription() | String | Zwraca opis tekstowy elementu strony. |
getHeight() | Number | Pobiera wysokość elementu w punktach, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji. |
getInherentHeight() | Number | Zwraca nieodłączną wysokość elementu podaną w punktach. |
getInherentWidth() | Number | Zwraca nieodłączną szerokość elementu w punktach. |
getLeft() | Number | Zwraca w punktach pozycję poziomą elementu mierzoną od lewego górnego rogu elementu strony, gdy element nie ma rotacji. |
getLink() | Link | Zwraca Link lub null , jeśli nie ma linku. |
getObjectId() | String | Zwraca unikalny identyfikator obiektu. |
getPageElementType() | PageElementType | Zwraca typ elementu strony reprezentowany jako wyliczenie PageElementType . |
getParentGroup() | Group | Zwraca grupę, do której należy ten element strony, lub null , jeśli element nie znajduje się w
grupy reklam. |
getParentPage() | Page | Zwraca stronę, na której znajduje się ten element strony. |
getParentPlaceholder() | PageElement | Zwraca nadrzędny element strony dla obiektu zastępczego. |
getPlaceholderIndex() | Integer | Zwraca indeks obrazu zastępczego. |
getPlaceholderType() | PlaceholderType | Zwraca typ obiektu zastępczego obrazu lub PlaceholderType.NONE , jeśli kształt nie jest odpowiedni
obiekt zastępczy. |
getRotation() | Number | Zwraca kąt obrotu elementu w prawo wokół jego środka, gdzie 0 stopni oznacza brak rotacji. |
getSourceUrl() | String | Pobiera źródłowy adres URL obrazu, jeśli jest dostępny. |
getTitle() | String | Zwraca tytuł tekstu alternatywnego elementu strony. |
getTop() | Number | Pobiera pionową pozycję elementu w punktach zmierzoną od lewego górnego rogu strony gdy element nie ma rotacji. |
getTransform() | AffineTransform | Zwraca przekształcenie elementu strony. |
getWidth() | Number | Zwraca szerokość elementu w punktach, która jest szerokością ramki ograniczającej elementu, gdy element nie ma rotacji. |
preconcatenateTransform(transform) | Image | Wstępnie łączy podane przekształcenie z istniejącym przekształceniem elementu strony. |
remove() | void | Usuwa element strony. |
removeLink() | void | Usuwa element 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 go
obrazu. |
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 obrazu. |
scaleHeight(ratio) | Image | Skaluje wysokość elementu według określonego współczynnika. |
scaleWidth(ratio) | Image | Skaluje szerokość elementu według określonego współczynnika. |
select() | void | Wybiera tylko element PageElement w aktywnej prezentacji i usuwa wszystkie poprzednie
wyboru. |
select(replace) | void | Wybiera element PageElement w aktywnej prezentacji. |
sendBackward() | Image | Przesuwa element strony o jeden element wstecz. |
sendToBack() | Image | Przesuwa element strony na tylną część strony. |
setDescription(description) | Image | Ustawia tekst alternatywny elementu strony. |
setHeight(height) | Image | Ustawia wysokość elementu w punktach, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji. |
setLeft(left) | Image | Określa pozycję elementu w poziomie w punktach, mierzoną od lewego górnego rogu elementu strony, gdy element nie ma rotacji. |
setLinkSlide(slideIndex) | Link | Ustawia Link na podaną wartość Slide za pomocą indeksu slajdu liczony od zera. |
setLinkSlide(slide) | Link | Ustawia element Link na podany element Slide , a link jest ustawiany przez podany identyfikator slajdu. |
setLinkSlide(slidePosition) | Link | Ustawia Link na podaną wartość Slide na podstawie względnej pozycji slajdu. |
setLinkUrl(url) | Link | Ustawia wartość Link na dany ciąg znaków adresu URL, który nie jest pusty. |
setRotation(angle) | Image | Ustawia kąt obrotu elementu w prawo dookoła jego środka (w stopniach). |
setTitle(title) | Image | Ustawia tytuł tekstu alternatywnego elementu strony. |
setTop(top) | Image | Określa pozycję elementu w pionie w punktach, zmierzoną od lewego górnego rogu strony gdy element nie ma rotacji. |
setTransform(transform) | Image | Ustawia przekształcenie elementu strony za pomocą podanego przekształcenia. |
setWidth(width) | Image | Ustawia szerokość elementu w punktach, która jest szerokością ramki ograniczającej elementu, gdy Element nie ma rotacji. |
Szczegółowa dokumentacja
alignOnPage(alignmentPosition)
Wyrównuje element do określonego położenia wyrównania na stronie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
alignmentPosition | AlignmentPosition | Położenie, do którego ma zostać wyrównany ten element strony. |
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
bringForward()
Przesuwa element strony o jeden element do przodu.
Element strony nie może należeć do grupy.
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
Przenosi element strony na początek.
Element strony nie może należeć do grupy.
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
Powiela element strony.
Zduplikowany element strony jest umieszczany na tej samej stronie i w tym samym położeniu co oryginał.
Powrót
PageElement
– nowy duplikat tego elementu strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAs(contentType)
Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ten dodaje do nazwy pliku odpowiednie rozszerzenie – na przykład „mojplik.pdf”. Jednak zakłada, że część nazwy pliku, która następuje po ostatnim kropce (jeśli występuje), jest już , które należy zastąpić. W rezultacie „ShoppingList.12.25.2014” zmienia się w „ShoppingList.12.25.pdf”.
Aby wyświetlić dzienne limity konwersji, zobacz Limity dla Google Usługi. Nowo utworzone domeny Google Workspace mogą być tymczasowo bardziej rygorystyczne limity.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Typ MIME do skonwertowania. W przypadku większości blobów atrybut 'application/pdf' to
jedyną prawidłową opcją. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG możesz też użyć dowolnej z tych wartości: 'image/bmp' , 'image/gif' , 'image/jpeg' lub 'image/png' .
prawidłowe. W przypadku dokumentów w Dokumentach Google prawidłowa jest też wartość 'text/markdown' . |
Powrót
Blob
– dane w postaci obiektu blob.
getBlob()
getBorder()
getConnectionSites()
Zwraca listę elementów ConnectionSite
w elemencie strony lub pustą listę, jeśli strona
z elementem nie ma żadnych połączonych stron.
Powrót
ConnectionSite[]
– lista witryn połączeń, która może być pusta, jeśli ten element nie ma stron połączenia.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getContentUrl()
Pobiera adres URL obrazu.
Ten adres URL jest otagowany kontem osoby wysyłającej prośbę, więc każda osoba, która posiada ten adres URL, uzyskuje dostęp do zdjęcia jako osoba, która zgłosiła pierwotne żądanie. Dostęp do obrazu może zostać utracony, jeśli ustawienia udostępniania prezentacji. Zwrócony adres URL wygasa po krótkim czasie.
Powrót
String
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
Zwraca opis tekstowy elementu strony. Opis jest połączony z tytułem wyświetlania i odczytywania tekstu alternatywnego.
Powrót
String
– opis tekstu alternatywnego elementu strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getHeight()
Pobiera wysokość elementu w punktach, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.
Powrót
Number
– nieodłączna wysokość elementu strony podana w punktach lub null
, jeśli element strony ma tak
nie mają wysokości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentHeight()
Zwraca nieodłączną wysokość elementu podaną w punktach.
Przekształcenie elementu strony zależy od jego rozmiaru. Używaj właściwego rozmiaru w wraz z przekształceniem elementu, aby określić jego ostateczny wygląd.
Powrót
Number
– nieodłączna wysokość elementu strony podana w punktach lub null
, jeśli element strony ma tak
nie mają wysokości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
Zwraca nieodłączną szerokość elementu w punktach.
Przekształcenie elementu strony zależy od jego rozmiaru. Używaj właściwego rozmiaru w wraz z przekształceniem elementu, aby określić jego ostateczny wygląd.
Powrót
Number
– maksymalna szerokość elementu strony podana w punktach lub null
, jeśli element strony ma tak
nie mają szerokości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
Zwraca w punktach pozycję poziomą elementu mierzoną od lewego górnego rogu elementu strony, gdy element nie ma rotacji.
Powrót
Number
– położenie tego elementu w poziomie w punktach w lewym górnym rogu strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLink()
Zwraca Link
lub null
, jeśli nie ma linku.
var link = shape.getLink(); if (link != null) { Logger.log('Shape has a link of type: ' + link.getLinkType()); }
Powrót
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getObjectId()
Zwraca unikalny identyfikator obiektu. Identyfikatory obiektów używane przez strony i ich elementy mają ten sam identyfikator w tej samej przestrzeni nazw.
Powrót
String
– unikalny identyfikator obiektu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
Zwraca typ elementu strony reprezentowany jako wyliczenie PageElementType
.
Powrót
PageElementType
– typ elementu strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
Zwraca grupę, do której należy ten element strony, lub null
, jeśli element nie znajduje się w
grupy reklam.
Powrót
Group
– grupa, do której należy ten element strony, lub null
.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPage()
Zwraca stronę, na której znajduje się ten element strony.
Powrót
Page
– strona, na której znajduje się ten element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPlaceholder()
Zwraca nadrzędny element strony dla obiektu zastępczego. Zwraca wartość null
, jeśli obraz nie jest
zastępczego lub bez elementu nadrzędnego.
Powrót
PageElement
– element nadrzędny strony obiektu zastępczego obrazu lub null
, jeśli obraz nie jest
jest zmienna lub nie ma elementu nadrzędnego.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderIndex()
Zwraca indeks obrazu zastępczego. Jeśli co najmniej 2 obrazy zastępcze na tej samej stronie
są tego samego typu, mają unikalną wartość indeksu Zwraca wartość null
, jeśli obraz nie jest
obiekt zastępczy.
Powrót
Integer
– indeks zastępczy obrazu lub null
, jeśli obraz nie jest obiektem zastępczym.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderType()
Zwraca typ obiektu zastępczego obrazu lub PlaceholderType.NONE
, jeśli kształt nie jest odpowiedni
obiekt zastępczy.
Powrót
PlaceholderType
– typ obiektu zastępczego obrazu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRotation()
Zwraca kąt obrotu elementu w prawo wokół jego środka, gdzie 0 stopni oznacza brak rotacji.
Powrót
Number
– kąt obrotu w stopniach od 0 (włącznie) do 360 (bez tej wartości).
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSourceUrl()
Pobiera źródłowy adres URL obrazu, jeśli jest dostępny.
Gdy obraz jest wstawiany za pomocą adresu URL, zwraca adres URL podany podczas wstawiania obrazu.
Powrót
String
– adres URL obrazu lub null
, jeśli obraz nie ma źródłowego adresu URL.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTitle()
Zwraca tytuł tekstu alternatywnego elementu strony. Tytuł jest połączony z opisem, aby wyświetlania i odczytywania tekstu alternatywnego.
Powrót
String
– tytuł tekstu alternatywnego elementu strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
Pobiera pionową pozycję elementu w punktach zmierzoną od lewego górnego rogu strony gdy element nie ma rotacji.
Powrót
Number
– położenie tego elementu w pionie w punktach w lewym górnym rogu strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
Zwraca przekształcenie elementu strony.
Wygląd elementu strony zależy od jego przekształcenia bezwzględnego. Do obliczanie przekształcenia bezwzględnego, wstępne łączenie przekształcenia elementu strony z przekształceniami wszystkich swoich grup nadrzędnych. Jeśli element strony nie należy do grupy, jego przekształcenie bezwzględne ma postać taka sama jak wartość w tym polu.
Powrót
AffineTransform
– przekształcenie elementu strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
Zwraca szerokość elementu w punktach, która jest szerokością ramki ograniczającej elementu, gdy element nie ma rotacji.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.
Powrót
Number
– maksymalna szerokość elementu strony podana w punktach lub null
, jeśli element strony ma tak
nie mają szerokości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
Wstępnie łączy podane przekształcenie z istniejącym przekształceniem elementu strony.
newTransform = argument * existingTransform
Aby np. przenieść elementy strony o 36 punktów w lewo:
element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder() .setTranslateX(-36.0) .build());
Możesz też zastąpić przekształcenie elementu strony funkcją setTransform(transform)
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
transform | AffineTransform | Przekształcenie, które zostanie wstępnie powiązane z przekształceniem tego elementu strony. |
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Usuwa element strony.
Jeśli po operacji usuwania element Group
zawiera tylko jeden element strony lub nie zawiera go, w parametrze
samej grupy zostanie również usunięta.
Jeśli obiekt zastępczy PageElement
zostanie usunięty z elementu głównego lub układu, wszystkie puste elementy dziedziczenia
zmienne również są usuwane.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
Usuwa element Link
.
shape.removeLink();
replace(blobSource)
Zastępuje ten obraz obrazem opisanym przez obiekt BlobSource
.
Wstawienie obrazu spowoduje jego pobranie z
BlobSource
, a kopia zostanie zapisana w prezentacji.
Zdjęcia muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w jednym
Format PNG, JPEG lub GIF.
Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z założeniami do rozmiaru istniejącego obrazu.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); image.replace(driveImage);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Dane obrazu. |
Powrót
Image
– Image
po wymianie.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(blobSource, crop)
Zastępuje ten obraz obrazem opisanym przez obiekt Image
, opcjonalnie przycinając go
odpowiedni obraz.
Wstawienie obrazu spowoduje jego pobranie z
BlobSource
, a kopia zostanie zapisana w prezentacji.
Zdjęcia muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w jednym
Format PNG, JPEG lub GIF.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); // Replace and crop the drive image. image.replace(driveImage, true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Dane obrazu. |
crop | Boolean | W przypadku opcji true obraz zostanie przycięty, aby pasował do rozmiaru istniejącego obrazu. W przeciwnym razie
obraz jest przeskalowany i wyśrodkowany. |
Powrót
Image
– Image
po wymianie.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl)
Zastępuje ten obraz innym obrazem pobranym z podanego adresu URL.
Wstawienie obrazu powoduje jego pobranie z adresu URL tylko raz, a jego kopia jest zapisywana w celu wyświetlenia prezentacji. Rozmiar zdjęć nie może przekraczać 50 MB, nie może przekraczać 25 megapikseli. być w formacie PNG, JPEG lub GIF.
Podany adres URL musi być publicznie dostępny i nie może być większy niż 2 kB. Sam URL jest zapisywany
i udostępniany za pomocą getSourceUrl()
.
Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z założeniami do rozmiaru istniejącego obrazu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL, z którego można pobrać obraz. |
Powrót
Image
– Image
po wymianie.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl, crop)
Zastępuje ten obraz innym obrazem pobranym z podanego adresu URL, opcjonalnie przycinając go obrazu.
Wstawienie obrazu powoduje jego pobranie z adresu URL tylko raz, a jego kopia jest zapisywana w celu wyświetlenia prezentacji. Rozmiar zdjęć nie może przekraczać 50 MB, nie może przekraczać 25 megapikseli. być w formacie PNG, JPEG lub GIF.
Podany adres URL nie może być większy niż 2 kB.
Parametry
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL, z którego można pobrać obraz. |
crop | Boolean | W przypadku opcji true obraz zostanie przycięty, aby pasował do rozmiaru istniejącego obrazu. W przeciwnym razie
obraz jest przeskalowany i wyśrodkowany. |
Powrót
Image
– Image
po wymianie.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
Skaluje wysokość elementu według określonego współczynnika. Wysokość elementu to wysokość jego ramkę ograniczającą, gdy element nie jest objęty obrotem.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
ratio | Number | Współczynnik skalowania wysokości tego elementu strony. |
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
Skaluje szerokość elementu według określonego współczynnika. Szerokość elementu to szerokość jego ramkę ograniczającą, gdy element nie jest objęty obrotem.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
ratio | Number | Współczynnik skalowania szerokości tego elementu strony. |
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Wybiera tylko element PageElement
w aktywnej prezentacji i usuwa wszystkie poprzednie
wyboru. Ta funkcja działa tak samo, jak nawiązanie połączenia z numerem select(replace)
w aplikacji true
.
Skrypt ma dostęp do wyboru użytkownika, który go uruchomił, i tylko wtedy, gdy skrypt jest powiązany z prezentacją.
Ustawia nadrzędny Page
elementu PageElement
na current page selection
.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
Wybiera element PageElement
w aktywnej prezentacji.
Skrypt ma dostęp do wyboru użytkownika, który go uruchomił, i tylko wtedy, gdy skrypt jest powiązany z prezentacją.
Przekaż true
do tej metody, aby wybrać tylko PageElement
i usunąć pozostałe
poprzedniego wyboru. Spowoduje to również ustawienie nadrzędnego Page
obiektu PageElement
jako
current page selection
Aby wybrać kilka obiektów PageElement
, miń false
. PageElement
obiekty muszą być w tym samym obiekcie Page
.
Podczas wybierania elementu strony za pomocą false
muszą być spełnione poniższe warunki
:
- Elementem nadrzędnym
Page
obiektuPageElement
musi byćcurrent page selection
. - Nie można zaznaczyć wielu obiektów
Page
.
Aby mieć pewność, że tak jest, najlepiej jest wybrać nadrzędny Page
.
najpierw za pomocą Page.selectAsCurrentPage()
, a następnie wybierz elementy strony na tej stronie.
var 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. var pageElements = slide.getPageElements(); for (var i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
replace | Boolean | Jeśli true , zastąpi dowolny poprzedni wybór; w przeciwnym razie
zostanie dodany do wcześniejszego zaznaczenia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
Przesuwa element strony o jeden element wstecz.
Element strony nie może należeć do grupy.
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
Przesuwa element strony na tylną część strony.
Element strony nie może należeć do grupy.
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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". var 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, dla którego ma zostać ustawiony tekst alternatywny opisu. |
Powrót
Image
– ten element strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
Ustawia wysokość elementu w punktach, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
height | Number | Nowa wysokość tego elementu strony do ustawienia (w punktach). |
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
Określa pozycję elementu w poziomie w punktach, mierzoną od lewego górnego rogu elementu strony, gdy element nie ma rotacji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
left | Number | Nowa pozycja w poziomie do ustawienia (w punktach). |
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
Ustawia Link
na podaną wartość Slide
za pomocą indeksu slajdu liczony od zera.
// Set a link to the first slide of the presentation. shape.setLinkSlide(0);
Parametry
Nazwa | Typ | Opis |
---|---|---|
slideIndex | Integer | Indeks liczony od zera dla slajdu. |
Powrót
Link
– Link
, który został ustawiony;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
Ustawia element Link
na podany element Slide
, a link jest ustawiany przez podany identyfikator slajdu.
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; shape.setLinkSlide(slide);
Parametry
Nazwa | Typ | Opis |
---|---|---|
slide | Slide | Slide do połączenia. |
Powrót
Link
– Link
, który został ustawiony;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
Ustawia Link
na podaną wartość Slide
na podstawie względnej pozycji slajdu.
// Set a link to the first slide of the presentation. shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);
Parametry
Nazwa | Typ | Opis |
---|---|---|
slidePosition | SlidePosition | Względna wartość SlidePosition . |
Powrót
Link
– Link
, który został ustawiony;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
Ustawia wartość Link
na dany ciąg znaków adresu URL, który nie jest pusty.
// Set a link to the URL. shape.setLinkUrl("https://slides.google.com");
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Ciąg adresu URL. |
Powrót
Link
– Link
, który został ustawiony;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
Ustawia kąt obrotu elementu w prawo dookoła jego środka (w stopniach).
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
angle | Number | Nowy kąt obrotu w prawo do ustawienia w stopniach. |
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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". var 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, dla którego należy ustawić tytuł tekstu alternatywnego. |
Powrót
Image
– ten element strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
Określa pozycję elementu w pionie w punktach, zmierzoną od lewego górnego rogu strony gdy element nie ma rotacji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
top | Number | Nowa pozycja w pionie do ustawienia (w punktach). |
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
Ustawia przekształcenie elementu strony za pomocą podanego przekształcenia.
Aktualizacja przekształcenia grupy zmienia przekształcenie bezwzględne elementów strony w co może zmienić ich wygląd.
Aktualizacja przekształcenia elementu strony, który należy do grupy, zmienia tylko przekształcenie ten element strony; Nie ma to wpływu na przekształcenia grupy ani innych elementów strony w grupy reklam.
Szczegółowe informacje na temat wpływu przekształceń na wygląd elementów strony znajdziesz na stronie getTransform()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
transform | AffineTransform | Przekształcenie ustawione dla tego elementu strony. |
Powrót
Image
– ten element służy do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
Ustawia szerokość elementu w punktach, która jest szerokością ramki ograniczającej elementu, gdy Element nie ma rotacji.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
width | Number | Nowa szerokość tego elementu strony do ustawienia (w punktach). |
Powrót
Image
– ten element strony służący do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations