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

Class Image

PageElement reprezentujący obraz.

Metody

Metoda	Zwracany typ	Krótki opis
`alignOnPage(alignmentPosition)`	`Image`	Wyrównuje element względem określonej pozycji na stronie.
`bringForward()`	`Image`	Powoduje przesuwanie elementu na stronie do przodu o 1 element.
`bringToFront()`	`Image`	Przenosi element strony na początek strony.
`duplicate()`	`PageElement`	Duplikuje element strony.
`getAs(contentType)`	`Blob`	Zwraca dane wewnątrz tego obiektu w postaci obiektu blob przekonwertowanego na określony typ treści.
`getBlob()`	`Blob`	Zwróć dane na tym obrazie 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 tekst alternatywny tekstu elementu strony.
`getHeight()`	`Number`	Pobiera wysokość punktów w punktach, czyli wysokość ramki ograniczającej elementu, gdy element nie ma obrotu.
`getInherentHeight()`	`Number`	Zwraca unikalną wysokość elementu w punktach.
`getInherentWidth()`	`Number`	Zwraca wewnętrzną szerokość elementu w punktach.
`getLeft()`	`Number`	Zwraca poziomą pozycję elementu w punktach mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.
`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 wyrażony w postaci wyliczenia `PageElementType`.
`getParentGroup()`	`Group`	Zwraca grupę, do której należy ten element strony, lub wartość `null`, jeśli elementu nie ma w grupie.
`getParentPage()`	`Page`	Zwraca stronę, na której znajduje się ten element strony.
`getParentPlaceholder()`	`PageElement`	Zwraca element nadrzędny strony zastępczej.
`getPlaceholderIndex()`	`Integer`	Zwraca indeks obrazu zastępczego.
`getPlaceholderType()`	`PlaceholderType`	Zwraca typ zmiennej obrazu lub `PlaceholderType.NONE`, jeśli kształt nie jest symbolem zastępczym.
`getRotation()`	`Number`	Zwraca kąt obrotu w prawo o stopnie (w stopniach), przy czym zero 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 pionie pozycję elementu mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.
`getTransform()`	`AffineTransform`	Zwraca przekształcenie elementu strony.
`getWidth()`	`Number`	Zwraca szerokość elementu w punktach, czyli szerokość ramki ograniczającej elementu, gdy element nie ma obrotu.
`preconcatenateTransform(transform)`	`Image`	Łączy wstępnie przekształconą wartość z dotychczasowym przekształceniem elementu strony.
`remove()`	`void`	Usuwa element strony.
`removeLink()`	`void`	Usuwa `Link`.
`replace(blobSource)`	`Image`	Zastępuje ten obraz obrazem opisanym za pomocą obiektu `BlobSource`.
`replace(blobSource, crop)`	`Image`	Zastępuje ten obraz obrazem opisanym za pomocą obiektu `Image`, opcjonalnie przycinając go do rozmiaru.
`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 można przyciąć obraz w celu dopasowania.
`scaleHeight(ratio)`	`Image`	Skaluje wysokość elementu o określony współczynnik.
`scaleWidth(ratio)`	`Image`	Skaluje szerokość elementu o określony współczynnik.
`select()`	`void`	Wybiera tylko `PageElement` w aktywnej prezentacji i usuwa poprzednie zaznaczenie.
`select(replace)`	`void`	Zaznacza element `PageElement` w aktywnej prezentacji.
`sendBackward()`	`Image`	Wysyła jeden element na stronie wstecz.
`sendToBack()`	`Image`	Wysyła element strony z tyłu strony.
`setDescription(description)`	`Image`	Ustawia tekst alternatywny elementu strony.
`setHeight(height)`	`Image`	Ustawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej elementu, gdy element nie jest obrócony.
`setLeft(left)`	`Image`	Ustawia poziomą pozycję elementu w punktach mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.
`setLinkSlide(slideIndex)`	`Link`	Ustawia wartość `Link` dla podanego parametru `Slide` przy użyciu indeksu opartego na zerze.
`setLinkSlide(slide)`	`Link`	Ustawia wartość `Link` dla podanego elementu `Slide`. Link jest ustawiany przez podany identyfikator slajdu.
`setLinkSlide(slidePosition)`	`Link`	Ustawia atrybut `Link` na określoną wartość `Slide` przy użyciu względnej pozycji slajdu.
`setLinkUrl(url)`	`Link`	Ustawia wartość `Link` dla danego niepustego ciągu adresu URL.
`setRotation(angle)`	`Image`	Ustawia kąt obrotu elementu w prawo o stopnie.
`setTitle(title)`	`Image`	Ustawia tytuł alternatywny tekstu elementu strony.
`setTop(top)`	`Image`	Określa w pionie pozycję elementu mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.
`setTransform(transform)`	`Image`	Ustawia przekształcenie elementu strony z użyciem tego przekształcenia.
`setWidth(width)`	`Image`	Określa szerokość elementu w punktach, czyli szerokość ramki ograniczającej elementu, gdy element nie ma obrotu.

Szczegółowa dokumentacja

`alignOnPage(alignmentPosition)`

Wyrównuje element względem określonej pozycji na stronie.

Parametry

Nazwa	Typ	Opis
`alignmentPosition`	`AlignmentPosition`	Pozycja wyrównania tego elementu strony na stronie.

Zwróć

Image – ten element strony na potrzeby łańcucha.

`bringForward()`

Powoduje przesuwanie elementu na stronie do przodu o 1 element.

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

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`bringToFront()`

Przenosi element strony na początek strony.

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

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 umieszczony na tej samej stronie w tej samej pozycji co oryginał.

Zwróć

PageElement – nowy duplikat tego elementu strony.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 w postaci obiektu blob przekonwertowanego na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, np. „mojplik.pdf”. Zakładamy jednak, że część nazwy pliku występująca po ostatnim okresie (jeśli istnieje) to istniejące rozszerzenie, które należy zastąpić. W związku z tym adres „ShoppingList.12.25.2014” zmieni się na „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zobacz Limity dla usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte ograniczeniami.

Parametry

Nazwa	Typ	Opis
`contentType`	`String`	Typ MIME, na który chcesz przekonwertować plik. W większości blobów jedyną prawidłową opcją jest `'application/pdf'`. W przypadku obrazów w formatach BMP, GIF, JPEG lub PNG prawidłowe są również te formaty: `'image/bmp'`, `'image/gif'`, `'image/jpeg'` i `'image/png'`.

Zwróć

Blob – dane jako obiekt blob.

`getBlob()`

Zwróć dane na tym obrazie jako obiekt blob.

Zwróć

Blob – dane obrazu jako obiekt blob.

`getBorder()`

Zwraca wartość Border obrazu.

Zwróć

Border – obramowanie obrazu.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn połączenia.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 otagowany kontem użytkownika zgłaszającego prośbę, więc każda osoba mająca ten adres URL uzyskuje dostęp do obrazu jako autora prośby. Jeśli ustawienia udostępniania prezentacji zostaną zmienione, możesz utracić dostęp do obrazu. Zwrócony adres URL wygasa po krótkim czasie.

Zwróć

String

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getDescription()`

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

Zwróć

String – opis alternatywny tekstu elementu strony.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getHeight()`

Pobiera wysokość punktów w punktach, czyli wysokość ramki ograniczającej elementu, gdy element nie ma obrotu.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Zwróć

Number – wewnętrzna wysokość elementu strony w punktach lub null, jeśli element strony nie ma wysokości.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getInherentHeight()`

Zwraca unikalną wysokość elementu w punktach.

Przekształcenie elementu strony jest zależne od jego nieodłącznego rozmiaru. Aby określić ostateczny wygląd elementu, użyj przekształcenia rozmiaru w połączeniu z transformacją elementu.

Zwróć

Number – wewnętrzna wysokość elementu strony w punktach lub null, jeśli element strony nie ma wysokości.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getInherentWidth()`

Zwraca wewnętrzną szerokość elementu w punktach.

Przekształcenie elementu strony jest zależne od jego nieodłącznego rozmiaru. Aby określić ostateczny wygląd elementu, użyj przekształcenia rozmiaru w połączeniu z transformacją elementu.

Zwróć

Number – rzeczywista szerokość elementu strony podana w punktach, a null, jeśli element strony nie ma szerokości.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 ma obrotu.

Zwróć

Number – położenie elementu w poziomie, w lewym górnym rogu strony.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Zwróć

Link

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 ich elementy mają taką samą przestrzeń nazw.

Zwróć

String – unikalny identyfikator tego obiektu;

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 wyrażony w postaci wyliczenia PageElementType.

Zwróć

PageElementType – typ elementu strony,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 wartość null, jeśli elementu nie ma w grupie.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getParentPlaceholder()`

Zwraca element nadrzędny strony zastępczej. Zwraca wartość null, jeśli obraz nie jest obiektem zastępczym lub nie ma obiektu nadrzędnego.

Zwróć

PageElement – element nadrzędny elementu zastępczego tego obrazu lub null, jeśli ten obraz nie jest symbolem zastępczym lub nie ma elementu nadrzędnego;

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 co najmniej 2 obrazy zastępcze na tej samej stronie są tego samego typu, każdy z nich ma unikalną wartość indeksu. Zwraca wartość null, jeśli obraz nie jest symbolem zastępczym.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getPlaceholderType()`

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

Zwróć

PlaceholderType – typ obiektu zastępczego tego obrazu.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 w prawo o stopnie (w stopniach), przy czym zero stopni oznacza brak obrotu.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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ł zostaje połączony z opisem, aby wyświetlać i czytać tekst alternatywny.

Zwróć

String – tytuł alternatywnego tekstu elementu strony.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getTop()`

Pobiera w pionie pozycję elementu mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.

Zwróć

Number – umiejscowienie tego elementu w punktach, w lewym górnym rogu strony;

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 na podstawie przekształcenia bezwzględnego. Aby obliczyć współczynnik bezwzględny, przełącz transformację elementu strony ze zmianami we wszystkich jego grupach nadrzędnych. Jeśli element strony nie znajduje się w grupie, jego bezwzględna przekształcenie jest taka sama jak wartość w tym polu.

Zwróć

AffineTransform – przekształcenie elementu strony.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 ma obrotu.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Zwróć

Number – rzeczywista szerokość elementu strony podana w punktach, a null, jeśli element strony nie ma szerokości.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`preconcatenateTransform(transform)`

Łączy wstępnie przekształconą wartość z dotychczasowym 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());

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

Parametry

Nazwa	Typ	Opis
`transform`	`AffineTransform`	Przekształcenie odpowiadające wstępnie przekształceniu tego elementu strony.

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 tag Group zawiera tylko 1 element strony lub nie zawiera go wcale, ta grupa też zostanie usunięta.

Jeśli obiekt zastępczy PageElement zostanie usunięty z szablonu głównego lub układu, zostaną też usunięte wszystkie puste obiekty dziedziczone.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 za pomocą obiektu BlobSource.

Wstawienie obrazu powoduje jednorazowe pobranie go z BlobSource oraz zapisanie jego kopii do wyświetlenia w prezentacji. Obrazy nie mogą być większe niż 50 MB, nie mogą być większe niż 25 megapikseli oraz muszą być w formacie PNG, JPEG lub GIF.

Aby zachować współczynnik proporcji obrazu, jest on 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.

Zwróć

Image – Image po zamianie.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 za pomocą obiektu Image, opcjonalnie przycinając go do rozmiaru.

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 `true` ma takie wymiary, przycina obraz do rozmiaru istniejącego. W przeciwnym razie obraz jest skalowany i wyśrodkowany.

Zwróć

Image – Image po zamianie.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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, a kopia jest przechowywana w celu wyświetlenia w ramach prezentacji. Obrazy nie mogą być większe niż 50 MB, nie mogą być większe niż 25 megapikseli oraz 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ą tagu getSourceUrl().

Aby zachować współczynnik proporcji obrazu, jest on 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.

Zwróć

Image – Image po zamianie.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 można przyciąć obraz w celu dopasowania.

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` ma takie wymiary, przycina obraz do rozmiaru istniejącego. W przeciwnym razie obraz jest skalowany i wyśrodkowany.

Zwróć

Image – Image po zamianie.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 o określony współczynnik. Wysokość elementu to wysokość ramki ograniczającej, gdy element nie ma obrotów.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Parametry

Nazwa	Typ	Opis
`ratio`	`Number`	Współczynnik służący do skalowania wysokości tego elementu strony.

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 o określony współczynnik. Szerokość elementu to szerokość ramki ograniczającej, gdy element nie jest obrócony.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Parametry

Nazwa	Typ	Opis
`ratio`	`Number`	Współczynnik służący do skalowania szerokości tego elementu strony.

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`select()`

Wybiera tylko PageElement w aktywnej prezentacji i usuwa poprzednie zaznaczenie. Działa to tak samo, jak dzwonię pod numer select(replace) za pomocą numeru true.

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

Spowoduje to ustawienie elementu nadrzędnego Page elementu 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, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`select(replace)`

Zaznacza element PageElement w aktywnej prezentacji.

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

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

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

Podczas wybierania elementu za pomocą parametru false należy spełnić te warunki:

Nadrzędny Page obiektu PageElement musi być current page selection.
Nie powinno być wybranych wielu obiektów Page.

Aby to zrobić, wybierz najpierw element nadrzędny Page przy użyciu Page.selectAsCurrentPage(), a potem 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 wybierzesz `true`, wybór zastąpi wcześniejszy wybór. W przeciwnym razie wybór zostanie dodany do poprzedniego.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`sendBackward()`

Wysyła jeden element na stronie wstecz.

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

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`sendToBack()`

Wysyła element strony z tyłu strony.

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

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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".
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 znaków, do którego ma zostać wysłany opis alternatywny.

Zwróć

Image – ten element strony,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 elementu, gdy element nie jest obrócony.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Parametry

Nazwa	Typ	Opis
`height`	`Number`	Nowa wysokość tego elementu strony, którą chcesz ustawić, w punktach.

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setLeft(left)`

Ustawia poziomą pozycję elementu w punktach mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.

Parametry

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

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setLinkSlide(slideIndex)`

Ustawia wartość Link dla podanego parametru Slide przy użyciu indeksu opartego na zerze.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Parametry

Nazwa	Typ	Opis
`slideIndex`	`Integer`	Indeks zależny od zera.

Zwróć

Link – Link, który został ustawiony

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setLinkSlide(slide)`

Ustawia wartość Link dla podanego elementu 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.

Zwróć

Link – Link, który został ustawiony

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setLinkSlide(slidePosition)`

Ustawia atrybut Link na określoną wartość Slide przy użyciu 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ędny `SlidePosition`.

Zwróć

Link – Link, który został ustawiony

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setLinkUrl(url)`

Ustawia wartość Link dla danego niepustego ciągu adresu URL.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Parametry

Nazwa	Typ	Opis
`url`	`String`	Ciąg adresu URL.

Zwróć

Link – Link, który został ustawiony

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 w prawo o stopnie.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Parametry

Nazwa	Typ	Opis
`angle`	`Number`	Nowy kąt obrotu w prawo (w stopniach).

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setTitle(title)`

Ustawia tytuł alternatywny tekstu 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 tekstowy, do którego ma zostać ustawiony tytuł alternatywny.

Zwróć

Image – ten element strony,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setTop(top)`

Określa w pionie pozycję elementu mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.

Parametry

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

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 z użyciem tego przekształcenia.

Aktualizacja przekształcenia grupy powoduje zmianę bezwzględnej liczby elementów strony w tej grupie, które mogą zmieniać wygląd.

Aktualizowanie przekształcenia elementu strony, który jest w grupie, zmienia tylko przekształcenie tego elementu strony. Nie ma wpływu na przekształcenie grupy ani innych elementów strony.

Aby dowiedzieć się więcej o tym, jak przekształcenia wpływają na wygląd elementów zamówienia, przeczytaj artykuł getTransform().

Parametry

Nazwa	Typ	Opis
`transform`	`AffineTransform`	Transformacja ustawiona dla tego elementu strony.

Zwróć

Image – ten element na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`setWidth(width)`

Określa szerokość elementu w punktach, czyli szerokość ramki ograniczającej elementu, gdy element nie ma obrotu.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Parametry

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

Zwróć

Image – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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