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

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

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

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

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

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.

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.

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

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.

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.

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