Class Image

Obraz

PageElement reprezentujący obraz.

Metody

MetodaZwracany typKrótki opis
alignOnPage(alignmentPosition)ImageWyrównuje element do określonej pozycji wyrównania na stronie.
bringForward()ImagePrzesuwa element strony o jeden element do przodu.
bringToFront()ImagePrzesuwa element strony na wierzch.
duplicate()PageElementDuplikuje element strony.
getAs(contentType)BlobZwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane z tego obrazu jako obiekt binarny.
getBorder()BorderZwraca 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()StringPobiera adres URL obrazu.
getDescription()StringZwraca opis tekstu alternatywnego elementu strony.
getHeight()Number|nullZwraca wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy nie jest on obrócony.
getInherentHeight()Number|nullZwraca domyślną wysokość elementu w punktach.
getInherentWidth()Number|nullZwraca wrodzoną szerokość elementu w punktach.
getLeft()NumberZwraca poziomą pozycję elementu w punktach, mierzoną od lewego górnego rogu strony, gdy element nie jest obrócony.
getLink()Link|nullJeśli nie ma linku, zwraca wartość Link lub null.
getObjectId()StringZwraca unikalny identyfikator tego obiektu.
getPageElementType()PageElementTypeZwraca typ elementu strony reprezentowany jako wyliczenie PageElementType.
getParentGroup()Group|nullZwraca grupę, do której należy ten element strony, lub null, jeśli element nie należy do grupy.
getParentPage()PageZwraca stronę, na której znajduje się ten element strony.
getParentPlaceholder()PageElement|nullZwraca element strony nadrzędnej symbolu zastępczego.
getPlaceholderIndex()Integer|nullZwraca indeks obrazu zastępczego.
getPlaceholderType()PlaceholderTypeZwraca typ symbolu zastępczego obrazu lub PlaceholderType.NONE, jeśli kształt nie jest symbolem zastępczym.
getRotation()NumberZwraca kąt obrotu elementu wokół jego środka w stopniach, gdzie 0 stopni oznacza brak obrotu.
getSourceUrl()String|nullPobiera adres URL źródła obrazu, jeśli jest dostępny.
getTitle()StringZwraca tytuł tekstu alternatywnego elementu strony.
getTop()NumberPobiera pozycję w pionie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.
getTransform()AffineTransformZwraca przekształcenie elementu strony.
getWidth()Number|nullZwraca 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()voidUsuwa element strony.
removeLink()voidUsuwa Link.
replace(blobSource)ImageZastępuje ten obraz obrazem opisanym przez obiekt BlobSource.
replace(blobSource, crop)ImageZastępuje ten obraz obrazem opisanym przez obiekt Image, opcjonalnie przycinając go, aby dopasować go do rozmiaru.
replace(imageUrl)ImageZastępuje ten obraz innym obrazem pobranym z podanego adresu URL.
replace(imageUrl, crop)ImageZastępuje ten obraz innym obrazem pobranym z podanego adresu URL, opcjonalnie przycinając go, aby dopasować go do rozmiaru.
scaleHeight(ratio)ImageSkaluje wysokość elementu o określony współczynnik.
scaleWidth(ratio)ImageSkaluje szerokość elementu o określony współczynnik.
select()voidZaznacza tylko PageElement w aktywnej prezentacji i usuwa poprzedni wybór.
select(replace)voidWybiera PageElement w aktywnej prezentacji.
sendBackward()ImagePrzesuwa element strony o jeden element do tyłu.
sendToBack()ImagePrzesuwa element strony na spód strony.
setDescription(description)ImageUstawia tekst alternatywny elementu strony.
setHeight(height)ImageUstawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej elementu, gdy element nie jest obrócony.
setLeft(left)ImageUstawia poziomą pozycję elementu w punktach, mierzoną od lewego górnego rogu strony, gdy element nie jest obrócony.
setLinkSlide(slideIndex)LinkUstawia Link na podany Slide, używając indeksu slajdu liczonego od zera.
setLinkSlide(slide)LinkUstawia Link na podany Slide, a link jest ustawiany przez podany identyfikator slajdu.
setLinkSlide(slidePosition)LinkUstawia Link na podany Slide, używając względnego położenia slajdu.
setLinkUrl(url)LinkUstawia Link na podany niepusty ciąg znaków URL.
setRotation(angle)ImageUstawia kąt obrotu elementu wokół jego środka zgodnie z ruchem wskazówek zegara w stopniach.
setTitle(title)ImageUstawia tytuł tekstu alternatywnego elementu strony.
setTop(top)ImageOkreśla pozycję w pionie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.
setTransform(transform)ImageUstawia przekształcenie elementu strony za pomocą podanego przekształcenia.
setWidth(width)ImageUstawia szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy nie jest on obrócony.

Szczegółowa dokumentacja

alignOnPage(alignmentPosition)

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

Parametry

NazwaTypOpis
alignmentPositionAlignmentPositionPozycja, 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.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma zostać przekonwertowany plik.

Powrót

Blob – dane w formie obiektu blob.

getBlob()

Zwraca dane z tego obrazu jako obiekt binarny.

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 zgłaszającego, więc każda osoba, która ma ten adres URL, uzyskuje dostęp do obrazu jako pierwotny zgłaszający. 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ść ramki ograniczającej element, gdy nie jest on 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.

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 – wrodzona 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

Jeśli nie ma linku, zwraca wartość Link lub null. 

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 co najmniej 2 obrazy zastępcze na tej samej stronie są 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 symbolu zastępczego tego obrazu lub null, jeśli obraz nie jest symbolem 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 pozycję w pionie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.

Powrót

Number – pozycja w pionie 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ć transformację bezwzględną, połącz transformację elementu strony z transformacjami 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.

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 – wrodzona 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;

Aby na przykład 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

NazwaTypOpis
transformAffineTransformPrzekształ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 usunięcia grupa Group zawiera tylko 1 element strony lub nie zawiera żadnego, 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

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

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

NazwaTypOpis
blobSourceBlobSourceDane obrazu.

Powrót

Image – ten 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 go, aby dopasować go do rozmiaru.

Wstawienie obrazu powoduje jednorazowe pobranie go z BlobSource, a kopia jest przechowywana 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. 

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

NazwaTypOpis
blobSourceBlobSourceDane obrazu.
cropBooleanJeśli true, przycina obraz, aby dopasować go do rozmiaru istniejącego obrazu. W przeciwnym razie obraz jest skalowany i wyśrodkowany.

Powrót

Image – ten 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

NazwaTypOpis
imageUrlStringAdres URL, z którego można pobrać obraz.

Powrót

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

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 nie może być większy niż 2 kB.

Parametry

NazwaTypOpis
imageUrlStringAdres URL, z którego można pobrać obraz.
cropBooleanJeśli true, przycina obraz, aby dopasować go do rozmiaru istniejącego obrazu. W przeciwnym razie obraz jest skalowany i wyśrodkowany.

Powrót

Image – ten 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 o określony współczynnik. Wysokość elementu to wysokość jego ramki ograniczającej, 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.

Parametry

NazwaTypOpis
ratioNumberWspółczynnik, przez który należy pomnożyć wysokość 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 o określony współczynnik. Szerokość elementu to szerokość jego ramki ograniczającej, 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.

Parametry

NazwaTypOpis
ratioNumberWspół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 elementu 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.

Naciśnij 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:

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

Aby się upewnić, że tak jest, najpierw wybierz element nadrzędny Page za pomocą 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

NazwaTypOpis
replaceBooleanJeś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

NazwaTypOpis
descriptionStringCiąg znaków, który ma być ustawiony jako opis tekstu alternatywnego.

Powrót

Image – element 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 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.

Parametry

NazwaTypOpis
heightNumberNowa 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)

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

Parametry

NazwaTypOpis
leftNumberNowa 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

NazwaTypOpis
slideIndexIntegerIndeks 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

NazwaTypOpis
slideSlideSlide 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

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

NazwaTypOpis
urlStringCią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.

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.

Parametry

NazwaTypOpis
angleNumberNowy kąt obrotu w prawo do ustawienia, w stopniach.

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

NazwaTypOpis
titleStringCiąg znaków, który ma być tytułem tekstu alternatywnego.

Powrót

Image – element 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 pozycję w pionie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.

Parametry

NazwaTypOpis
topNumberNowa pozycja w pionie 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

NazwaTypOpis
transformAffineTransformPrzekształ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ść ramki ograniczającej element, gdy nie jest on 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.

Parametry

NazwaTypOpis
widthNumberNowa 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