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 do przodu o jeden element. |
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 | Zwróć dane wewnątrz tego obrazu jako obiekt blob. |
getBorder() | Border | Zwraca wartość Border obrazu. |
getConnectionSites() | ConnectionSite[] | Zwraca listę ConnectionSite w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn łączących. |
getContentUrl() | String | Pobiera adres URL obrazu. |
getDescription() | String | Zwraca opis tekstu alternatywnego elementu strony. |
getHeight() | Number | Pobiera wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie ma obrotu. |
getInherentHeight() | Number | Zwraca całkowitą wysokość elementu w punktach. |
getInherentWidth() | Number | Zwraca nieodłączną szerokość elementu w punktach. |
getLeft() | Number | Zwraca pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został 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 (wyliczenie PageElementType ). |
getParentGroup() | Group | Zwraca grupę, do której należy ten element strony, lub null , jeśli element nie należy do grupy. |
getParentPage() | Page | Zwraca stronę, na której znajduje się ten element strony. |
getParentPlaceholder() | PageElement | Zwraca nadrzędny element strony obiektu zastępczego. |
getPlaceholderIndex() | Integer | Zwraca indeks obrazu zastępczego. |
getPlaceholderType() | PlaceholderType | Zwraca typ symbolu zastępczego obrazu lub PlaceholderType.NONE , jeśli kształt nie jest obiektem zastępczym. |
getRotation() | Number | Zwraca kąt obrotu elementu w prawo wokół jego środka wyrażony w stopniach, gdzie 0 stopni oznacza brak obrotu. |
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 pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został obracany. |
getTransform() | AffineTransform | Zwraca przekształcenie elementu strony. |
getWidth() | Number | Zwraca szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu. |
preconcatenateTransform(transform) | Image | Wstępnie łączy podane przekształcenie z istniejącym przekształceniem 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 go, aby pasował. |
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, aby go dopasować. |
scaleHeight(ratio) | Image | Skaluje wysokość elementu o określony współczynnik. |
scaleWidth(ratio) | Image | Skaluje szerokość elementu o określony współczynnik. |
select() | void | Zaznacza tylko element PageElement w aktywnej prezentacji i usuwa wszystkie wcześniejsze zaznaczenie. |
select(replace) | void | Zaznacza PageElement w aktywnej prezentacji. |
sendBackward() | Image | Przesuwa element strony o jeden element wstecz. |
sendToBack() | Image | Przenosi element strony na jej tył. |
setDescription(description) | Image | Ustawia alternatywny opis tekstu elementu strony. |
setHeight(height) | Image | Ustawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie podlega obracaniu. |
setLeft(left) | Image | Ustawia pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie podlega obracaniu. |
setLinkSlide(slideIndex) | Link | Ustawia w polu Link wartość Slide przy użyciu indeksu slajdu liczonego od zera. |
setLinkSlide(slide) | Link | Ustawia w polu Link wartość Slide . Link jest ustawiany przez podany identyfikator slajdu. |
setLinkSlide(slidePosition) | Link | Ustawia element Link na Slide przy użyciu względnego położenia slajdu. |
setLinkUrl(url) | Link | Ustawia Link na podany niepusty ciąg adresu URL. |
setRotation(angle) | Image | Ustawia kąt obrotu elementu wokół jego środka w prawo w stopniach. |
setTitle(title) | Image | Ustawia tytuł tekstu alternatywnego elementu strony. |
setTop(top) | Image | Ustawia pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie jest obracany. |
setTransform(transform) | Image | Ustawia przekształcenie elementu strony przy użyciu podanego przekształcenia. |
setWidth(width) | Image | Ustawia szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu. |
Szczegółowa dokumentacja
alignOnPage(alignmentPosition)
Wyrównuje element do określonego położenia wyrównania na stronie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
alignmentPosition | AlignmentPosition | Pozycja, do której ma zostać wyrównany ten element strony na stronie. |
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
bringForward()
Przesuwa element strony do przodu o jeden element.
Element strony nie może należeć do grupy.
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
Przenosi element strony na początek.
Element strony nie może należeć do grupy.
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
Powiela element strony.
Zduplikowany element strony jest umieszczony na tej samej stronie w tym samym miejscu co strona oryginalna.
Powroty
PageElement
– nowy duplikat danego elementu strony.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAs(contentType)
Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mójplik.pdf”. Zakładamy jednak, że część nazwy pliku, która występuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W związku z tym „Lista zakupów.12.25.2014” zmieni się na „Lista zakupów.12.25.pdf”.
Aby sprawdzić dzienne limity konwersji, przeczytaj artykuł Limity w usługach Google. Nowo utworzone domeny Google Workspace mogą tymczasowo podlegać bardziej rygorystycznym limitom.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Typ MIME, na który ma zostać przekonwertowany. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf' . W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG obowiązują dowolne z tych wartości: 'image/bmp' , 'image/gif' , 'image/jpeg' i 'image/png' . |
Powroty
Blob
– dane w postaci obiektu blob.
getBlob()
Zwróć dane wewnątrz tego obrazu jako obiekt blob.
Powroty
Blob
– dane obrazu w postaci obiektu blob.
getBorder()
getConnectionSites()
Zwraca listę ConnectionSite
w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn łączących.
Powroty
ConnectionSite[]
– lista witryn połączeń, która może być pusta, jeśli ten element nie ma żadnych witryn połączeń.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getContentUrl()
Pobiera adres URL obrazu.
Do tego adresu URL dodano tag z kontem zgłaszającego prośbę, więc każda osoba, która go otrzymała, faktycznie uzyskuje dostęp do obrazu jako zgłaszająca. Dostęp do obrazu może zostać utracony, jeśli zmienią się ustawienia udostępniania prezentacji. Zwrócony adres URL wygasa po krótkim czasie.
Powroty
String
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
Zwraca opis tekstu alternatywnego elementu strony. Opis jest łączony z tytułem, aby umożliwić wyświetlenie i odczytanie tekstu alternatywnego.
Powroty
String
– opis tekstu alternatywnego elementu strony.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getHeight()
Pobiera wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie ma obrotu.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.
Powroty
Number
– całkowita wysokość elementu strony w punktach lub null
, jeśli element strony nie ma wysokości.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentHeight()
Zwraca całkowitą wysokość elementu w punktach.
Przekształcenie elementu strony zależy od jego naturalnego rozmiaru. Użyj właściwego rozmiaru w połączeniu z transformacją elementu, aby określić ostateczny wygląd elementu.
Powroty
Number
– całkowita wysokość elementu strony w punktach lub null
, jeśli element strony nie ma wysokości.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
Zwraca nieodłączną szerokość elementu w punktach.
Przekształcenie elementu strony zależy od jego naturalnego rozmiaru. Użyj właściwego rozmiaru w połączeniu z transformacją elementu, aby określić ostateczny wygląd elementu.
Powroty
Number
– wewnętrzna szerokość elementu strony w punktach lub null
, jeśli element strony nie ma szerokości.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
Zwraca pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został obracany.
Powroty
Number
– położenie tego elementu w poziomie w punktach od lewego górnego rogu strony.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLink()
Zwraca wartość 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()); }
Powroty
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getObjectId()
Zwraca unikalny identyfikator tego obiektu. Identyfikatory obiektów używane przez strony i elementy stron mają tę samą przestrzeń nazw.
Powroty
String
– unikalny identyfikator obiektu,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
Zwraca typ elementu strony (wyliczenie PageElementType
).
Powroty
PageElementType
– typ elementu strony.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
Zwraca grupę, do której należy ten element strony, lub null
, jeśli element nie należy do grupy.
Powroty
Group
– grupa, do której należy ten element strony, lub null
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPage()
Zwraca stronę, na której znajduje się ten element strony.
Powroty
Page
– strona, na której znajduje się ten element.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPlaceholder()
Zwraca nadrzędny element strony obiektu zastępczego. Zwraca wartość null
, jeśli obraz nie jest obiektem zastępczym lub nie ma elementu nadrzędnego.
Powroty
PageElement
– nadrzędny element strony danego obiektu zastępczego obrazu lub null
, jeśli obraz nie jest symbolem zastępczym lub nie ma elementu nadrzędnego.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderIndex()
Zwraca indeks obrazu zastępczego. Jeśli dwa lub więcej obrazów zastępczych na tej samej stronie jest tego samego typu, każdy z nich ma unikalną wartość indeksu. Zwraca wartość null
, jeśli obraz nie jest symbolem zastępczym.
Powroty
Integer
– indeks zastępczy obrazu lub null
, jeśli obraz nie jest symbolem zastępczym.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderType()
Zwraca typ symbolu zastępczego obrazu lub PlaceholderType.NONE
, jeśli kształt nie jest obiektem zastępczym.
Powroty
PlaceholderType
– typ symbolu zastępczego danego obrazu.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRotation()
Zwraca kąt obrotu elementu w prawo wokół jego środka wyrażony w stopniach, gdzie 0 stopni oznacza brak obrotu.
Powroty
Number
– kąt obrotu w stopniach między 0 (włącznie) a 360 (bez tej wartości).
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSourceUrl()
Pobiera źródłowy adres URL obrazu, jeśli jest dostępny.
Jeśli obraz został wstawiony za pomocą adresu URL, zwraca adres URL podany podczas wstawiania obrazu.
Powroty
String
– adres URL obrazu lub null
, jeśli obraz nie ma adresu URL źródła.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTitle()
Zwraca tytuł tekstu alternatywnego elementu strony. Tytuł jest łączony z opisem, aby wyświetlić i odczytać tekst alternatywny.
Powroty
String
– tytuł tekstu alternatywnego elementu strony.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
Pobiera pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został obracany.
Powroty
Number
– położenie tego elementu w pionie (w punktach) od lewego górnego rogu strony.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
Zwraca przekształcenie elementu strony.
Wygląd elementu strony zależy od jego bezwzględnego przekształcenia. Aby obliczyć przekształcenie bezwzględne, połącz wstępnie przekształcenie elementu strony z przekształceniami wszystkich jego grup nadrzędnych. Jeśli element strony nie należy do grupy, jego przekształcenie bezwzględne jest takie samo jak wartość w tym polu.
Powroty
AffineTransform
– przekształcenie elementu strony.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
Zwraca szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.
Powroty
Number
– wewnętrzna szerokość elementu strony w punktach lub null
, jeśli element strony nie ma szerokości.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
Wstępnie łączy podane przekształcenie z istniejącym przekształceniem elementu strony.
newTransform = argument * existingTransform
Aby na przykład przenieść elementy strony o 36 punktów w lewo:
element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder() .setTranslateX(-36.0) .build());
Przekształcenie elementu strony możesz też zastąpić elementem setTransform(transform)
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
transform | AffineTransform | Transformacja, która ma zostać wstępnie połączona z przekształceniem tego elementu strony. |
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Usuwa element strony.
Jeśli po operacji usuwania element Group
zawiera tylko jeden element strony lub nie zawiera go wcale, sama grupa również jest usuwana.
Jeśli z obiektu głównego lub układu zostanie usunięty obiekt zastępczy PageElement
, wszystkie puste dziedziczące symbole zastępcze też zostaną usunięte.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
Usuwa: Link
.
shape.removeLink();
replace(blobSource)
Zastępuje ten obraz obrazem opisanym przez obiekt BlobSource
.
Wstawienie obrazu powoduje jednorazowe pobranie go z
BlobSource
i zapisanie kopii do wyświetlenia w prezentacji.
Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także muszą być w formacie PNG, JPEG lub GIF.
Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z rozmiarem 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. |
Powroty
Image
– ten Image
po wymianie.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(blobSource, crop)
Zastępuje ten obraz obrazem opisanym przez obiekt Image
, opcjonalnie przycinając go, aby pasował.
Wstawienie obrazu powoduje jednorazowe pobranie go z
BlobSource
i zapisanie kopii do wyświetlenia w prezentacji.
Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także muszą być w formacie 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 | Jeśli wybierzesz true , obraz zostanie przycięty do rozmiaru istniejącego. W przeciwnym razie obraz zostanie przeskalowany i wyśrodkowany. |
Powroty
Image
– ten Image
po wymianie.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl)
Zastępuje ten obraz innym obrazem pobranym z podanego adresu URL.
Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL, a jego kopia zostaje zapisana i wyświetlana w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także format PNG, JPEG lub GIF.
Podany adres URL musi być publicznie dostępny, a jego rozmiar nie może przekraczać 2 KB. Adres URL jest zapisywany wraz z obrazem i wyświetlany w elemencie getSourceUrl()
.
Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z rozmiarem istniejącego obrazu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL, z którego można pobrać obraz. |
Powroty
Image
– ten Image
po wymianie.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl, crop)
Zastępuje ten obraz innym obrazem pobranym z podanego adresu URL, opcjonalnie przycinając go, aby go dopasować.
Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL, a jego kopia zostaje zapisana i wyświetlana w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także format PNG, JPEG lub GIF.
Podany adres URL 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 | Jeśli wybierzesz true , obraz zostanie przycięty do rozmiaru istniejącego. W przeciwnym razie obraz zostanie przeskalowany i wyśrodkowany. |
Powroty
Image
– ten Image
po wymianie.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
Skaluje wysokość elementu o określony współczynnik. Wysokość elementu to wysokość jego ramki ograniczającej, gdy element nie podlega obracaniu.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
ratio | Number | Współczynnik skalowania wysokości tego elementu strony. |
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
Skaluje szerokość elementu o określony współczynnik. Szerokość elementu to szerokość jego ramki ograniczającej, gdy element nie podlega obracaniu.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
ratio | Number | Współczynnik skalowania szerokości tego elementu strony. |
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Zaznacza tylko element PageElement
w aktywnej prezentacji i usuwa wszystkie wcześniejsze zaznaczenie. Ta funkcja działa tak samo jak wywołanie select(replace)
w aplikacji true
.
Skrypt ma dostęp tylko do użytkownika, który ma go uruchamiać, i tylko wtedy, gdy jest powiązany z prezentacją.
Spowoduje to ustawienie elementu nadrzędnego Page
obiektu PageElement
jako 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();
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
Zaznacza PageElement
w aktywnej prezentacji.
Skrypt ma dostęp tylko do użytkownika, który ma go uruchamiać, i tylko wtedy, gdy jest powiązany z prezentacją.
Przekaż true
do tej metody, aby wybrać tylko PageElement
i usunąć wcześniejsze zaznaczenie. Spowoduje to też ustawienie elementu nadrzędnego Page
obiektu PageElement
jako current page selection
.
Przekazuj false
, aby wybrać wiele obiektów PageElement
. Obiekty PageElement
muszą być w tej samej wartości Page
.
Podczas wybierania elementu strony za pomocą parametru false
muszą być spełnione te warunki:
- Elementem nadrzędnym
Page
obiektuPageElement
musi byćcurrent page selection
. - Nie powinno być wybranych wielu obiektów
Page
.
Aby mieć pewność, że tak jest, najlepiej jest najpierw wybrać element nadrzędny Page
za pomocą elementu Page.selectAsCurrentPage()
, a potem wybrać 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 ustawiona jest wartość true , wybór zastępuje dowolny wcześniej wybrany. W przeciwnym razie wybrany element zostanie dodany do dowolnego z wcześniejszych elementów. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
Przesuwa element strony o jeden element wstecz.
Element strony nie może należeć do grupy.
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
Przenosi element strony na jej tył.
Element strony nie może należeć do grupy.
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setDescription(description)
Ustawia alternatywny opis tekstu 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, na który ma być ustawiony opis tekstu alternatywnego. |
Powroty
Image
– ten element strony.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
Ustawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie podlega obracaniu.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
height | Number | Nowa wysokość tego elementu strony do ustawienia (w punktach). |
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
Ustawia pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie podlega obracaniu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
left | Number | Nowa pozycja w poziomie do ustawienia w punktach. |
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
Ustawia w polu Link
wartość Slide
przy użyciu indeksu slajdu liczonego 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. |
Powroty
Link
– ustawiona wartość Link
,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
Ustawia w polu Link
wartość Slide
. 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. |
Powroty
Link
– ustawiona wartość Link
,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
Ustawia element Link
na Slide
przy użyciu względnego położenia slajdu.
// Set a link to the first slide of the presentation. shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);
Parametry
Nazwa | Typ | Opis |
---|---|---|
slidePosition | SlidePosition | Względny SlidePosition . |
Powroty
Link
– ustawiona wartość Link
,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
Ustawia Link
na podany niepusty ciąg adresu URL.
// Set a link to the URL. shape.setLinkUrl("https://slides.google.com");
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Ciąg adresu URL. |
Powroty
Link
– ustawiona wartość Link
,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
Ustawia kąt obrotu elementu wokół jego środka w prawo w stopniach.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
angle | Number | Nowy kąt obrotu w prawo (w stopniach). |
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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, na który ma zostać ustawiony tytuł tekstu alternatywnego. |
Powroty
Image
– ten element strony.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
Ustawia pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie jest obracany.
Parametry
Nazwa | Typ | Opis |
---|---|---|
top | Number | Nowa pozycja w pionie do ustawienia w punktach. |
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
Ustawia przekształcenie elementu strony przy użyciu podanego przekształcenia.
Zaktualizowanie przekształcenia grupy zmienia bezwzględne przekształcenie elementów strony w tej grupie, co może zmienić ich wygląd.
Aktualizowanie przekształcenia elementu strony, który należy do grupy, powoduje tylko zmianę przekształcenia tego elementu strony – nie ma wpływu na przekształcenia tej grupy ani innych elementów strony w tej grupie.
Szczegółowe informacje o tym, jak przekształcenia wpływają na wygląd elementów strony, znajdziesz w sekcji getTransform()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
transform | AffineTransform | Przekształcenie ustawione dla tego elementu strony. |
Powroty
Image
– element do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
Ustawia szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu.
Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
width | Number | Nowa szerokość tego elementu strony do ustawienia (w punktach). |
Powroty
Image
– ten element strony używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations