Ta strona została przetłumaczona przez Cloud Translation API.

Class Image

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 wartość `Border` obrazu.
`getConnectionSites()`	`ConnectionSite[]`	Zwraca listę elementów `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 tekstowy elementu strony.
`getHeight()`	`Number`	Pobiera wysokość elementu w punktach, która jest wysokością ramki ograniczającej elementu, gdy element nie podlega obrocie.
`getInherentHeight()`	`Number`	Zwraca nieodłączną wysokość elementu podaną 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 jest obracany.
`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 należy do grupy.
`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 obiektem zastępczym.
`getRotation()`	`Number`	Zwraca kąt obrotu elementu w prawo wokół jego środka, przy czym 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 w punktach pozycję pionową elementu zmierzoną od lewego górnego rogu strony, gdy element nie jest obracany.
`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 obraz, aby dopasować się do niego.
`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 rozmiaru.
`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 zaznaczenia.
`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 podlega obrocie.
`setLeft(left)`	`Image`	Określa pozycję elementu w poziomie w punktach, mierzoną od lewego górnego rogu strony, gdy element nie jest obracany.
`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 pionową pozycję elementu w punktach, zmierzoną 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, 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 należy wyrównać ten element strony na stronie.

Powroty

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.

Powroty

Image – ten element strony służący 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 służący 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 umieszczany na tej samej stronie i w tym samym położeniu co oryginał.

Powroty

PageElement – nowy duplikat tego 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 „mojplik.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 efekcie „ShoppingList.12.25.2014” zmieni się na „ShoppingList.12.25.pdf”.

Dzienne limity konwersji znajdziesz w artykule Limity dla usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.

Parametry

Nazwa	Typ	Opis
`contentType`	`String`	Typ MIME do skonwertowania. W przypadku większości blobów jedyną prawidłową opcją jest `'application/pdf'`. 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'`.

Powroty

Blob – dane w postaci obiektu blob.

`getBlob()`

Zwraca dane wewnątrz obrazu jako obiekt blob.

Powroty

Blob – dane obrazu w postaci obiektu blob.

`getBorder()`

Zwraca wartość Border obrazu.

Powroty

Border – obramowanie 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

`getConnectionSites()`

Zwraca listę elementów ConnectionSite w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn połączenia.

Powroty

ConnectionSite[] – lista witryn połączeń, która może być pusta, jeśli ten element nie ma stron połączenia.

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.

Adres URL jest otagowany kontem osoby wysyłającej prośbę, więc każda osoba, która go ma, uzyskuje dostęp do obrazu jako osoba zgłaszająca prośbę. Jeśli zmienisz ustawienia udostępniania prezentacji, możesz utracić dostęp do obrazu. 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 tekstowy elementu strony. Opis jest połączony z tytułem, który wyświetla i odczytuje tekst alternatywny.

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, która jest wysokością ramki ograniczającej elementu, gdy element nie podlega obrocie.

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 pozycji.

Powroty

Number – maksymalna wysokość elementu strony podana 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 nieodłączną wysokość elementu podaną w punktach.

Przekształcenie elementu strony zależy od jego rozmiaru. Aby określić ostateczny wygląd elementu, użyj rozmiaru wewnętrznego w połączeniu z przekształceniem elementu.

Powroty

Number – maksymalna wysokość elementu strony podana 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 rozmiaru. Aby określić ostateczny wygląd elementu, użyj rozmiaru wewnętrznego w połączeniu z przekształceniem elementu.

Powroty

Number – maksymalna szerokość elementu strony podana 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 jest obracany.

Powroty

Number – położenie tego elementu w poziomie w punktach w lewym górnym 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 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

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

`getObjectId()`

Zwraca unikalny identyfikator obiektu. Identyfikatory obiektów używane przez strony i ich elementy mają taką 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 reprezentowany jako 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 dla obiektu zastępczego. Zwraca null, jeśli obraz nie jest obiektem zastępczym lub nie ma elementu nadrzędnego.

Powroty

PageElement – element strony nadrzędnej obiektu zastępczego obrazu lub null, jeśli obraz nie jest obiektem 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 co najmniej 2 obrazy zastępcze na tej samej stronie są tego samego typu, każdy z nich będzie miał unikalną wartość indeksu. Zwraca wartość null, jeśli obraz nie jest obiektem zastępczym.

Powroty

Integer – indeks zastępczy obrazu lub null, jeśli obraz nie jest obiektem 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 obiektu zastępczego obrazu lub PlaceholderType.NONE, jeśli kształt nie jest obiektem zastępczym.

Powroty

PlaceholderType – typ obiektu zastępczego 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, przy czym 0 stopni oznacza brak obrotu.

Powroty

Number – kąt obrotu w stopniach od 0 (włącznie) do 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.

Gdy obraz jest wstawiany za pomocą adresu URL, zwraca adres URL podany podczas wstawiania obrazu.

Powroty

String – adres URL obrazu lub null, jeśli obraz nie ma źródłowego adresu URL.

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 połą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 w punktach pozycję pionową elementu zmierzoną od lewego górnego rogu strony, gdy element nie jest obracany.

Powroty

Number – położenie tego elementu w pionie w punktach w lewym górnym 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 przekształcenia bezwzględnego. 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, 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 są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycji.

Powroty

Number – maksymalna szerokość elementu strony podana 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 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.

Powroty

Image – ten element strony służący 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 żadnego, sama grupa również zostanie usunięta.

Jeśli obiekt zastępczy PageElement zostanie usunięty z elementu głównego lub układu, wszystkie puste dziedziczone zmienne również 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 element Link.

shape.removeLink();

`replace(blobSource)`

Zastępuje ten obraz obrazem opisanym przez obiekt BlobSource.

Wstawienie obrazu powoduje jego pobranie z BlobSource tylko raz, a jego kopia jest przechowywana w celu wyświetlenia w prezentacji. Rozmiar obrazu nie może przekraczać 50 MB, nie może przekraczać 25 megapikseli i musi być w formacie PNG, JPEG lub GIF.

Aby zachować współczynnik proporcji obrazu, obraz jest skalowany i wyśrodkowany względem 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.

Powroty

Image – 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 obraz, aby dopasować się do niego.

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 zostanie przeskalowany i wyśrodkowany.

Powroty

Image – 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 jego pobranie z adresu URL tylko raz, a kopia jest zapisywana do wyświetlenia w prezentacji. Rozmiar obrazu nie może przekraczać 50 MB, nie może przekraczać 25 megapikseli i musi 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 adres URL jest zapisywany razem z obrazem i udostępniany przez getSourceUrl().

Aby zachować współczynnik proporcji obrazu, obraz jest skalowany i wyśrodkowany względem rozmiaru istniejącego obrazu.

Parametry

Nazwa	Typ	Opis
`imageUrl`	`String`	Adres URL, z którego można pobrać obraz.

Powroty

Image – 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 do rozmiaru.

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 zostanie przeskalowany i wyśrodkowany.

Powroty

Image – 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 według określonego współczynnika. Wysokość elementu to wysokość jego ramki ograniczającej, gdy element nie podlega obrocie.

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 pozycji.

Parametry

Nazwa	Typ	Opis
`ratio`	`Number`	Współczynnik skalowania wysokości tego elementu strony.

Powroty

Image – ten element strony służący 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 według określonego współczynnika. Szerokość elementu to szerokość jego ramki ograniczającej, gdy element nie ma rotacji.

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 pozycji.

Parametry

Nazwa	Typ	Opis
`ratio`	`Number`	Współczynnik skalowania szerokości tego elementu strony.

Powroty

Image – ten element strony służący 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()`

Wybiera tylko element PageElement w aktywnej prezentacji i usuwa wszystkie poprzednie zaznaczenia. Ta funkcja działa tak samo, jak nawiązanie połączenia z numerem select(replace) w aplikacji true.

Skrypt ma dostęp tylko do wyboru użytkownika, który go uruchamia, 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();

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)`

Wybiera element PageElement w aktywnej prezentacji.

Skrypt ma dostęp tylko do wyboru użytkownika, który go uruchamia, i tylko wtedy, gdy skrypt jest powiązany z prezentacją.

Przekaż true do tej metody, aby wybrać tylko PageElement i usunąć wcześniejszy wybór. Spowoduje to również ustawienie nadrzędnego Page obiektu PageElement na current page selection.

Aby wybrać kilka obiektów PageElement, miń false. Obiekty PageElement muszą być w tym samym obiekcie Page.

Podczas wybierania elementu strony za pomocą parametru false muszą być spełnione te warunki:

Elementem nadrzędnym Page obiektu PageElement musi być current page selection.
Nie można zaznaczyć wielu obiektów Page.

Aby mieć pewność, że tak jest, najlepiej jest wybrać najpierw element nadrzędny Page za pomocą elementu Page.selectAsCurrentPage(), a następnie elementy tej strony.

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 wartość `true`, zastąpi dowolny poprzedni wybór. W przeciwnym razie zaznaczenie zostanie dodane do poprzedniego zaznaczenia.

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 służący 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()`

Przesuwa element strony na tylną część strony.

Element strony nie może należeć do grupy.

Powroty

Image – ten element strony służący 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 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 tekstowy, dla którego ma zostać ustawiony tekst alternatywny opisu.

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, która jest wysokością ramki ograniczającej elementu, gdy element nie podlega obrocie.

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 pozycji.

Parametry

Nazwa	Typ	Opis
`height`	`Number`	Nowa wysokość tego elementu strony do ustawienia (w punktach).

Powroty

Image – ten element strony służący 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)`

Określa pozycję elementu w poziomie w punktach, mierzoną od lewego górnego rogu strony, gdy element nie jest obracany.

Parametry

Nazwa	Typ	Opis
`left`	`Number`	Nowa pozycja w poziomie do ustawienia (w punktach).

Powroty

Image – ten element strony służący 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 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.

Powroty

Link – Link, który został ustawiony;

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 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.

Powroty

Link – Link, który został ustawiony;

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 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`.

Powroty

Link – Link, który został ustawiony;

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 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.

Powroty

Link – Link, który został ustawiony;

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 w prawo dookoła jego środka (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 pozycji.

Parametry

Nazwa	Typ	Opis
`angle`	`Number`	Nowy kąt obrotu w prawo do ustawienia w stopniach.

Powroty

Image – ten element strony służący 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, dla którego należy ustawić 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)`

Określa pionową pozycję elementu w punktach, zmierzoną 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 służący 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 za pomocą podanego przekształcenia.

Aktualizacja przekształcenia grupy zmienia transformację bezwzględną elementów strony w tej grupie, co może zmienić ich wygląd.

Aktualizacja przekształcenia elementu strony, który jest w grupie, zmienia tylko przekształcenie tego elementu strony i nie ma wpływu na przekształcenia grupy ani innych elementów strony, które należą do grupy.

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.

Powroty

Image – ten element służy 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, 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 są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycji.

Parametry

Nazwa	Typ	Opis
`width`	`Number`	Nowa szerokość tego elementu strony do ustawienia (w punktach).

Powroty

Image – ten element strony służący 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