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

Class Image

Symbol PageElement reprezentujący obraz.

Metody

Metoda	Zwracany typ	Krótki opis
`alignOnPage(alignmentPosition)`	`Image`	Wyrównuje element do określonej pozycji wyrównania na stronie.
`bringForward()`	`Image`	Przesuwa element strony o jeden element do przodu.
`bringToFront()`	`Image`	Przesuwa element strony na wierzch.
`duplicate()`	`PageElement`	Duplikuje element strony.
`getAs(contentType)`	`Blob`	Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści.
`getBlob()`	`Blob`	Zwróć dane z tego obrazu jako obiekt blob.
`getBorder()`	`Border`	Zwraca `Border` obrazu.
`getConnectionSites()`	`ConnectionSite[]`	Zwraca listę elementów `ConnectionSite` na elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn połączeń.
`getContentUrl()`	`String`	Pobiera adres URL obrazu.
`getDescription()`	`String`	Zwraca opis tekstu alternatywnego elementu strony.
`getHeight()`	`Number\|null`	Zwraca wysokość elementu w punktach, czyli wysokość pola ograniczającego elementu, gdy element nie jest obrócony.
`getInherentHeight()`	`Number\|null`	Zwraca domyślną wysokość elementu w punktach.
`getInherentWidth()`	`Number\|null`	Zwraca wrodzoną szerokość elementu w punktach.
`getLeft()`	`Number`	Zwraca poziomą pozycję elementu w punktach, mierzoną od lewego górnego rogu strony, gdy element nie jest obrócony.
`getLink()`	`Link\|null`	Zwraca wartość `Link` lub `null`, jeśli nie ma linku.
`getObjectId()`	`String`	Zwraca unikalny identyfikator tego obiektu.
`getPageElementType()`	`PageElementType`	Zwraca typ elementu strony reprezentowany jako wyliczenie `PageElementType`.
`getParentGroup()`	`Group\|null`	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\|null`	Zwraca element strony nadrzędnej symbolu zastępczego.
`getPlaceholderIndex()`	`Integer\|null`	Zwraca indeks obrazu zastępczego.
`getPlaceholderType()`	`PlaceholderType`	Zwraca typ symbolu zastępczego obrazu lub `PlaceholderType.NONE`, jeśli kształt nie jest symbolem zastępczym.
`getRotation()`	`Number`	Zwraca kąt obrotu elementu wokół jego środka w stopniach, gdzie 0 stopni oznacza brak obrotu.
`getSourceUrl()`	`String\|null`	Pobiera adres URL źródła obrazu, jeśli jest dostępny.
`getTitle()`	`String`	Zwraca tytuł tekstu alternatywnego elementu strony.
`getTop()`	`Number`	Pobiera pionowe położenie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.
`getTransform()`	`AffineTransform`	Zwraca przekształcenie elementu strony.
`getWidth()`	`Number\|null`	Zwraca szerokość elementu w punktach, czyli szerokość ramki ograniczającej elementu, gdy element nie jest obrócony.
`preconcatenateTransform(transform)`	`Image`	Łączy podaną transformację z istniejącą transformacją elementu strony.
`remove()`	`void`	Usuwa element strony.
`removeLink()`	`void`	Usuwa `Link`.
`replace(blobSource)`	`Image`	Zastępuje ten obraz obrazem opisanym przez obiekt `BlobSource`.
`replace(blobSource, crop)`	`Image`	Zastępuje ten obraz obrazem opisanym przez obiekt `Image`, opcjonalnie przycinając obraz, aby go dopasować.
`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 dopasować go do miejsca docelowego.
`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`	Zaznacza tylko `PageElement` w aktywnej prezentacji i usuwa poprzedni wybór.
`select(replace)`	`void`	Wybiera `PageElement` w aktywnej prezentacji.
`sendBackward()`	`Image`	Przesuwa element strony o jeden element do tyłu.
`sendToBack()`	`Image`	Przesuwa element strony na spód strony.
`setDescription(description)`	`Image`	Ustawia tekst alternatywny elementu strony.
`setHeight(height)`	`Image`	Ustawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy nie jest on obrócony.
`setLeft(left)`	`Image`	Określa położenie elementu w poziomie w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.
`setLinkSlide(slideIndex)`	`Link`	Ustawia `Link` na podany `Slide`, używając indeksu slajdu liczonego od zera.
`setLinkSlide(slide)`	`Link`	Ustawia `Link` na podany `Slide`, a link jest ustawiany przez podany identyfikator slajdu.
`setLinkSlide(slidePosition)`	`Link`	Ustawia `Link` na podany `Slide`, używając względnego położenia slajdu.
`setLinkUrl(url)`	`Link`	Ustawia `Link` na podany niepusty ciąg znaków adresu URL.
`setRotation(angle)`	`Image`	Ustawia kąt obrotu elementu wokół jego środka zgodnie z ruchem wskazówek zegara w stopniach.
`setTitle(title)`	`Image`	Ustawia tytuł tekstu alternatywnego elementu strony.
`setTop(top)`	`Image`	Określa pionowe położenie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.
`setTransform(transform)`	`Image`	Ustawia przekształcenie elementu strony za pomocą podanego przekształcenia.
`setWidth(width)`	`Image`	Ustawia szerokość elementu w punktach, czyli szerokość pola ograniczającego elementu, gdy element nie jest obrócony.

Szczegółowa dokumentacja

`alignOnPage(alignmentPosition)`

Wyrównuje element do określonej pozycji wyrównania na stronie.

Parametry

Nazwa	Typ	Opis
`alignmentPosition`	`AlignmentPosition`	Pozycja, do której ma być wyrównany ten element strony.

Powrót

Image – ten element strony służy do łączenia.

`bringForward()`

Przesuwa element strony o jeden element do przodu.

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

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`bringToFront()`

Przesuwa element strony na wierzch.

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

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`duplicate()`

Duplikuje element strony.

Zduplikowany element strony jest umieszczany na tej samej stronie w tym samym miejscu co oryginał.

Powrót

PageElement – nowy duplikat tego elementu strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getAs(contentType)`

Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, np. „mójplik.pdf”. Zakłada jednak, że część nazwy pliku, która następuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W konsekwencji nazwa „ShoppingList.12.25.2014” zmieni się na „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zapoznaj się z artykułem Limity usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.

Parametry

Nazwa	Typ	Opis
`contentType`	`String`	Typ MIME, na który ma zostać przekonwertowany plik. W przypadku większości obiektów blob jedyną prawidłową opcją jest `'application/pdf'`. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są też znaki `'image/bmp'`, `'image/gif'`, `'image/jpeg'` i `'image/png'`. W przypadku dokumentu Google `'text/markdown'` jest również prawidłowy.

Powrót

Blob – dane w formie obiektu blob.

`getBlob()`

Zwróć dane z tego obrazu jako obiekt blob.

Powrót

Blob – dane obrazu w formie obiektu blob.

`getBorder()`

Zwraca Border obrazu.

Powrót

Border – obramowanie obrazu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getConnectionSites()`

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getContentUrl()`

Pobiera adres URL obrazu.

Ten adres URL jest oznaczony kontem osoby wysyłającej żądanie, więc każda osoba, która ma ten adres URL, uzyskuje dostęp do obrazu jako pierwotny wnioskodawca. Dostęp do obrazu może zostać utracony, jeśli zmienią się ustawienia udostępniania prezentacji. Zwrócony URL wygasa po krótkim czasie.

Powrót

String

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getDescription()`

Zwraca opis tekstu alternatywnego elementu strony. Opis jest łączony z tytułem, aby wyświetlać i odczytywać tekst alternatywny.

Powrót

String – tekst alternatywny elementu strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getHeight()`

Zwraca wysokość elementu w punktach, czyli wysokość pola ograniczającego elementu, gdy element nie jest obrócony.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony nie są zgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i położenia.

Powrót

Number|null – domyślna wysokość elementu strony w punktach lub null, jeśli element strony nie ma wysokości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentHeight()`

Zwraca domyślną wysokość elementu w punktach.

Przekształcenie elementu strony jest względne w stosunku do jego naturalnego rozmiaru. Użyj rozmiaru wbudowanego w połączeniu z przekształceniem elementu, aby określić jego ostateczny wygląd.

Powrót

Number|null – domyślna wysokość elementu strony w punktach lub null, jeśli element strony nie ma wysokości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentWidth()`

Zwraca wrodzoną szerokość elementu w punktach.

Powrót

Number|null – wbudowana szerokość elementu strony w punktach lub null, jeśli element strony nie ma szerokości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLeft()`

Zwraca poziomą pozycję elementu w punktach, mierzoną od lewego górnego rogu strony, gdy element nie jest obrócony.

Powrót

Number – poziome położenie tego elementu w punktach, liczone od lewego górnego rogu strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLink()`

Zwraca wartość Link lub null, jeśli nie ma linku.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

Powrót

Link|null – Link lub null, jeśli nie ma linku.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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.

Powrót

String – unikalny identyfikator tego obiektu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPageElementType()`

Zwraca typ elementu strony reprezentowany jako wyliczenie PageElementType.

Powrót

PageElementType – typ elementu strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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.

Powrót

Group|null – grupa, do której należy ten element strony, lub null.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPage()`

Zwraca stronę, na której znajduje się ten element strony.

Powrót

Page – strona, na której znajduje się ten element.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPlaceholder()`

Zwraca element strony nadrzędnej symbolu zastępczego. Zwraca null, jeśli obraz nie jest obrazem zastępczym lub nie ma elementu nadrzędnego.

Powrót

PageElement|null – element strony nadrzędnej tego symbolu zastępczego obrazu lub null, jeśli ten obraz nie jest symbolem zastępczym lub nie ma elementu nadrzędnego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 na tej samej stronie znajdują się co najmniej 2 obrazy zastępcze tego samego typu, każdy z nich ma unikalną wartość indeksu. Zwraca null, jeśli obraz nie jest obiektem zastępczym.

Powrót

Integer|null – indeks obrazu zastępczego lub null, jeśli obraz nie jest obrazem zastępczym.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholderType()`

Zwraca typ symbolu zastępczego obrazu lub PlaceholderType.NONE, jeśli kształt nie jest symbolem zastępczym.

Powrót

PlaceholderType – typ symbolu zastępczego tego obrazu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getRotation()`

Zwraca kąt obrotu elementu wokół jego środka w stopniach, gdzie 0 stopni oznacza brak obrotu.

Powrót

Number – kąt obrotu w stopniach z zakresu od 0 (włącznie) do 360 (wyłącznie).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getSourceUrl()`

Pobiera adres URL źródła obrazu, jeśli jest dostępny.

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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świetlać i odczytywać tekst alternatywny.

Powrót

String – tytuł tekstu alternatywnego elementu strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTop()`

Pobiera pionowe położenie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.

Powrót

Number – pionowe położenie tego elementu w punktach, liczone od lewego górnego rogu strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 jest określany przez jego przekształcenie bezwzględne. Aby obliczyć przekształcenie bezwzględne, połącz przekształcenie elementu strony z przekształceniami wszystkich jego grup nadrzędnych. Jeśli element strony nie należy do grupy, jego bezwzględne przekształcenie jest takie samo jak wartość w tym polu.

Powrót

AffineTransform – przekształcenie elementu strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 elementu, gdy element nie jest obrócony.

Powrót

Number|null – wbudowana szerokość elementu strony w punktach lub null, jeśli element strony nie ma szerokości.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`preconcatenateTransform(transform)`

Łączy podaną transformację z istniejącą transformacją elementu strony.

newTransform = argument * existingTransform;

Jeśli na przykład chcesz przesunąć elementy strony o 36 punktów w lewo:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

Możesz też zastąpić przekształcenie elementu strony wartością setTransform(transform).

Parametry

Nazwa	Typ	Opis
`transform`	`AffineTransform`	Przekształcenie, które ma zostać wstępnie połączone z przekształceniem tego elementu strony.

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 grupa Group zawiera tylko 1 element strony lub nie zawiera ich wcale, sama grupa również zostanie usunięta.

Jeśli symbol zastępczy PageElement zostanie usunięty z wzorca lub układu, wszystkie puste symbole zastępcze dziedziczone również zostaną usunięte.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`removeLink()`

Usuwa Link.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

`replace(blobSource)`

Zastępuje ten obraz obrazem opisanym przez obiekt BlobSource.

Wstawienie obrazu powoduje jednorazowe pobranie go z BlobSource, a kopia jest przechowywana w celu wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.

Aby zachować format obrazu, jest on skalowany i wyśrodkowywany względem rozmiaru istniejącego obrazu.

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById("123abc");
image.replace(driveImage);

Parametry

Nazwa	Typ	Opis
`blobSource`	`BlobSource`	Dane obrazu.

Powrót

Image – to Image po wymianie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 go dopasować.

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the drive image.
image.replace(driveImage, true);

Parametry

Nazwa	Typ	Opis
`blobSource`	`BlobSource`	Dane obrazu.
`crop`	`Boolean`	Jeśli `true`, przycina obraz, aby dopasować go do rozmiaru istniejącego obrazu. W przeciwnym razie obraz jest skalowany i wyśrodkowywany.

Powrót

Image – to Image po wymianie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 i zapisanie kopii do wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.

Podany adres URL musi być dostępny publicznie i nie może przekraczać 2 KB. Sam adres URL jest zapisywany z obrazem i udostępniany za pomocą getSourceUrl().

Aby zachować format obrazu, jest on skalowany i wyśrodkowywany względem rozmiaru istniejącego obrazu.

Parametry

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

Powrót

Image – to Image po wymianie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 dopasować go do miejsca docelowego.

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 `true`, przycina obraz, aby dopasować go do rozmiaru istniejącego obrazu. W przeciwnym razie obraz jest skalowany i wyśrodkowywany.

Powrót

Image – to Image po wymianie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 pola ograniczającego, gdy element nie jest obrócony.

Parametry

Nazwa	Typ	Opis
`ratio`	`Number`	Współczynnik, o który należy przeskalować wysokość tego elementu strony.

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 pola ograniczenia, gdy element nie jest obrócony.

Parametry

Nazwa	Typ	Opis
`ratio`	`Number`	Współczynnik, o który należy przeskalować szerokość tego elementu strony.

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select()`

Zaznacza tylko PageElement w aktywnej prezentacji i usuwa poprzedni wybór. Odpowiada to wywołaniu funkcji select(replace) z argumentem true.

Skrypt może uzyskać dostęp do zaznaczenia użytkownika, który go uruchamia, tylko wtedy, gdy jest powiązany z prezentacją.

Spowoduje to ustawienie nadrzędnego Page elementu PageElement jako current page selection.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select(replace)`

Wybiera PageElement w aktywnej prezentacji.

Skrypt może uzyskać dostęp do zaznaczenia użytkownika, który go uruchamia, tylko wtedy, gdy jest powiązany z prezentacją.

Przekaż do tej metody wartość true, aby wybrać tylko PageElement i usunąć poprzedni wybór. Ustawia to też element nadrzędny Page elementu PageElement jako current page selection.

Przesuń false, aby wybrać wiele obiektów PageElement. Obiekty PageElement muszą znajdować się w tym samym Page.

Podczas wybierania elementu strony za pomocą parametru false musisz spełnić te warunki:

Elementem nadrzędnym Page obiektu PageElement musi być current page selection.
Nie powinno być wybranych wielu obiektów Page.

Aby się upewnić, że tak jest, najpierw wybierz element nadrzędny Page za pomocą elementu Page.selectAsCurrentPage(), a potem wybierz elementy strony na tej stronie.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parametry

Nazwa	Typ	Opis
`replace`	`Boolean`	Jeśli `true`, wybór zastępuje poprzedni wybór; w przeciwnym razie wybór jest dodawany do poprzedniego wyboru.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendBackward()`

Przesuwa element strony o jeden element do tyłu.

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

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendToBack()`

Przesuwa element strony na spód strony.

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

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setDescription(description)`

Ustawia tekst alternatywny elementu strony.

Ta metoda nie jest obsługiwana w przypadku elementów Group.

// Set the first page element's alt text description to "new alt text
// description".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parametry

Nazwa	Typ	Opis
`description`	`String`	Ciąg znaków, który ma być ustawiony jako opis tekstu alternatywnego.

Powrót

Image – element tej strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 nie jest on obrócony.

Parametry

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

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLeft(left)`

Określa położenie elementu w poziomie w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.

Parametry

Nazwa	Typ	Opis
`left`	`Number`	Nowa pozycja pozioma do ustawienia w punktach.

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slideIndex)`

Ustawia Link na podany Slide, używając indeksu slajdu liczonego od zera.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

Parametry

Nazwa	Typ	Opis
`slideIndex`	`Integer`	Indeks slajdu liczony od zera.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slide)`

Ustawia Link na podany Slide, a link jest ustawiany przez podany identyfikator slajdu.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

Parametry

Nazwa	Typ	Opis
`slide`	`Slide`	`Slide` do połączenia.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slidePosition)`

Ustawia Link na podany Slide, używając względnego położenia slajdu.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Parametry

Nazwa	Typ	Opis
`slidePosition`	`SlidePosition`	Względna `SlidePosition`.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkUrl(url)`

Ustawia Link na podany niepusty ciąg znaków adresu URL.

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

Parametry

Nazwa	Typ	Opis
`url`	`String`	Ciąg znaków URL.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setRotation(angle)`

Ustawia kąt obrotu elementu wokół jego środka zgodnie z ruchem wskazówek zegara w stopniach.

Parametry

Nazwa	Typ	Opis
`angle`	`Number`	Nowy kąt obrotu w stopniach, który ma zostać ustawiony.

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTitle(title)`

Ustawia tytuł tekstu alternatywnego elementu strony.

Ta metoda nie jest obsługiwana w przypadku elementów Group.

// Set the first page element's alt text title to "new alt text title".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parametry

Nazwa	Typ	Opis
`title`	`String`	Ciąg znaków, który ma być tytułem tekstu alternatywnego.

Powrót

Image – element tej strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTop(top)`

Określa pionowe położenie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.

Parametry

Nazwa	Typ	Opis
`top`	`Number`	Nowa pozycja pionowa do ustawienia w punktach.

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 bezwzględne przekształcenie elementów strony w tej grupie, co może zmienić ich wygląd.

Aktualizacja przekształcenia elementu strony, który znajduje się w grupie, zmienia tylko przekształcenie tego elementu strony. Nie wpływa na przekształcenia grupy ani innych elementów strony w grupie.

Więcej informacji o tym, jak przekształcenia wpływają na wygląd elementów strony, znajdziesz w artykule getTransform().

Parametry

Nazwa	Typ	Opis
`transform`	`AffineTransform`	Przekształcenie ustawione dla tego elementu strony.

Powrót

Image – ten element do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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ść pola ograniczającego elementu, gdy element nie jest obrócony.

Parametry

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

Powrót

Image – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

Class Image Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Metody

Szczegółowa dokumentacja

alignOnPage(alignmentPosition)

Parametry

Powrót

bringForward()

Powrót

Autoryzacja

bringToFront()

Powrót

Autoryzacja

duplicate()

Powrót

Autoryzacja

getAs(contentType)

Parametry

Powrót

getBlob()

Powrót

getBorder()

Powrót

Autoryzacja

getConnectionSites()

Powrót

Autoryzacja

getContentUrl()

Powrót

Autoryzacja

getDescription()

Powrót

Autoryzacja

getHeight()

Powrót

Autoryzacja

getInherentHeight()

Powrót

Autoryzacja

getInherentWidth()

Powrót

Autoryzacja

getLeft()

Powrót

Autoryzacja

getLink()

Powrót

Autoryzacja

getObjectId()

Powrót

Autoryzacja

getPageElementType()

Powrót

Autoryzacja

getParentGroup()

Powrót

Autoryzacja

getParentPage()

Powrót

Autoryzacja

getParentPlaceholder()

Powrót

Autoryzacja

getPlaceholderIndex()

Powrót

Autoryzacja

getPlaceholderType()

Powrót

Autoryzacja

getRotation()

Powrót

Autoryzacja

getSourceUrl()

Powrót

Autoryzacja

getTitle()

Powrót

Autoryzacja

getTop()

Powrót

Autoryzacja

Class Image

`alignOnPage(alignmentPosition)`

`bringForward()`

`bringToFront()`

`duplicate()`

`getAs(contentType)`

`getBlob()`

`getBorder()`

`getConnectionSites()`

`getContentUrl()`

`getDescription()`

`getHeight()`

`getInherentHeight()`

`getInherentWidth()`

`getLeft()`

`getLink()`

`getObjectId()`

`getPageElementType()`

`getParentGroup()`

`getParentPage()`

`getParentPlaceholder()`

`getPlaceholderIndex()`

`getPlaceholderType()`

`getRotation()`

`getSourceUrl()`

`getTitle()`

`getTop()`

`getTransform()`

`getWidth()`

`preconcatenateTransform(transform)`

`remove()`

`removeLink()`

`replace(blobSource)`

`replace(blobSource, crop)`

`replace(imageUrl)`

`replace(imageUrl, crop)`

`scaleHeight(ratio)`

`scaleWidth(ratio)`

`select()`

`select(replace)`

`sendBackward()`

`sendToBack()`

`setDescription(description)`

`setHeight(height)`

`setLeft(left)`

`setLinkSlide(slideIndex)`

`setLinkSlide(slide)`

`setLinkSlide(slidePosition)`