Class Image

Image

Element PageElement reprezentujący obraz.

Metody

MetodaZwracany typKrótki opis
alignOnPage(alignmentPosition)ImageWyrównuje element do określonego położenia wyrównania na stronie.
bringForward()ImagePrzesuwa element strony do przodu o jeden element.
bringToFront()ImagePrzenosi element strony na początek.
duplicate()PageElementPowiela element strony.
getAs(contentType)BlobZwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwróć dane wewnątrz tego obrazu jako obiekt blob.
getBorder()BorderZwraca wartość Border obrazu.
getConnectionSites()ConnectionSite[]Zwraca listę ConnectionSite w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn łączących.
getContentUrl()StringPobiera adres URL obrazu.
getDescription()StringZwraca opis tekstu alternatywnego elementu strony.
getHeight()NumberPobiera wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie ma obrotu.
getInherentHeight()NumberZwraca całkowitą wysokość elementu w punktach.
getInherentWidth()NumberZwraca nieodłączną szerokość elementu w punktach.
getLeft()NumberZwraca pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został obracany.
getLink()LinkZwraca wartość Link lub null, jeśli nie ma linku.
getObjectId()StringZwraca unikalny identyfikator tego obiektu.
getPageElementType()PageElementTypeZwraca typ elementu strony (wyliczenie PageElementType).
getParentGroup()GroupZwraca 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()PageElementZwraca nadrzędny element strony obiektu zastępczego.
getPlaceholderIndex()IntegerZwraca indeks obrazu zastępczego.
getPlaceholderType()PlaceholderTypeZwraca typ symbolu zastępczego obrazu lub PlaceholderType.NONE, jeśli kształt nie jest obiektem zastępczym.
getRotation()NumberZwraca kąt obrotu elementu w prawo wokół jego środka wyrażony w stopniach, gdzie 0 stopni oznacza brak obrotu.
getSourceUrl()StringPobiera źródłowy adres URL obrazu, jeśli jest dostępny.
getTitle()StringZwraca tytuł tekstu alternatywnego elementu strony.
getTop()NumberPobiera pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został obracany.
getTransform()AffineTransformZwraca przekształcenie elementu strony.
getWidth()NumberZwraca szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu.
preconcatenateTransform(transform)ImageWstępnie łączy podane przekształcenie z istniejącym przekształceniem 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 pasował.
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 go dopasować.
scaleHeight(ratio)ImageSkaluje wysokość elementu o określony współczynnik.
scaleWidth(ratio)ImageSkaluje szerokość elementu o określony współczynnik.
select()voidZaznacza tylko element PageElement w aktywnej prezentacji i usuwa wszystkie wcześniejsze zaznaczenie.
select(replace)voidZaznacza PageElement w aktywnej prezentacji.
sendBackward()ImagePrzesuwa element strony o jeden element wstecz.
sendToBack()ImagePrzenosi element strony na jej tył.
setDescription(description)ImageUstawia alternatywny opis tekstu elementu strony.
setHeight(height)ImageUstawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie podlega obracaniu.
setLeft(left)ImageUstawia pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie podlega obracaniu.
setLinkSlide(slideIndex)LinkUstawia w polu Link wartość Slide przy użyciu indeksu slajdu liczonego od zera.
setLinkSlide(slide)LinkUstawia w polu Link wartość Slide. Link jest ustawiany przez podany identyfikator slajdu.
setLinkSlide(slidePosition)LinkUstawia element Link na Slide przy użyciu względnego położenia slajdu.
setLinkUrl(url)LinkUstawia Link na podany niepusty ciąg adresu URL.
setRotation(angle)ImageUstawia kąt obrotu elementu wokół jego środka w prawo w stopniach.
setTitle(title)ImageUstawia tytuł tekstu alternatywnego elementu strony.
setTop(top)ImageUstawia pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie jest obracany.
setTransform(transform)ImageUstawia przekształcenie elementu strony przy użyciu podanego przekształcenia.
setWidth(width)ImageUstawia szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu.

Szczegółowa dokumentacja

alignOnPage(alignmentPosition)

Wyrównuje element do określonego położenia wyrównania na stronie.

Parametry

NazwaTypOpis
alignmentPositionAlignmentPositionPozycja, do której ma zostać wyrównany ten element strony na stronie.

Powroty

Image – ten element strony używany do tworzenia łańcuchów.


bringForward()

Przesuwa element strony do przodu o jeden element.

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

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

bringToFront()

Przenosi element strony na początek.

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

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

duplicate()

Powiela element strony.

Zduplikowany element strony jest umieszczony na tej samej stronie w tym samym miejscu co strona oryginalna.

Powroty

PageElement – nowy duplikat danego elementu strony.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getAs(contentType)

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mójplik.pdf”. Zakładamy jednak, że część nazwy pliku, która występuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W związku z tym „Lista zakupów.12.25.2014” zmieni się na „Lista zakupów.12.25.pdf”.

Aby sprawdzić dzienne limity konwersji, przeczytaj artykuł Limity w usługach Google. Nowo utworzone domeny Google Workspace mogą tymczasowo podlegać bardziej rygorystycznym limitom.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma zostać przekonwertowany. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf'. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG obowiązują dowolne z tych wartości: 'image/bmp', 'image/gif', 'image/jpeg' i 'image/png'.

Powroty

Blob – dane w postaci obiektu blob.


getBlob()

Zwróć dane wewnątrz tego obrazu jako obiekt blob.

Powroty

Blob – dane obrazu w postaci obiektu blob.


getBorder()

Zwraca wartość Border obrazu.

Powroty

Border – obramowanie obrazu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getConnectionSites()

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

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getContentUrl()

Pobiera adres URL obrazu.

Do tego adresu URL dodano tag z kontem zgłaszającego prośbę, więc każda osoba, która go otrzymała, faktycznie uzyskuje dostęp do obrazu jako zgłaszająca. Dostęp do obrazu może zostać utracony, jeśli zmienią się ustawienia udostępniania prezentacji. Zwrócony adres URL wygasa po krótkim czasie.

Powroty

String

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getDescription()

Zwraca opis tekstu alternatywnego elementu strony. Opis jest łączony z tytułem, aby umożliwić wyświetlenie i odczytanie tekstu alternatywnego.

Powroty

String – opis tekstu alternatywnego elementu strony.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getHeight()

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

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.

Powroty

Number – całkowita wysokość elementu strony w punktach lub null, jeśli element strony nie ma wysokości.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getInherentHeight()

Zwraca całkowitą wysokość elementu w punktach.

Przekształcenie elementu strony zależy od jego naturalnego rozmiaru. Użyj właściwego rozmiaru w połączeniu z transformacją elementu, aby określić ostateczny wygląd elementu.

Powroty

Number – całkowita wysokość elementu strony w punktach lub null, jeśli element strony nie ma wysokości.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getInherentWidth()

Zwraca nieodłączną szerokość elementu w punktach.

Przekształcenie elementu strony zależy od jego naturalnego rozmiaru. Użyj właściwego rozmiaru w połączeniu z transformacją elementu, aby określić ostateczny wygląd elementu.

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getLeft()

Zwraca pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został obracany.

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

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

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

Powroty

Link

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getObjectId()

Zwraca unikalny identyfikator tego obiektu. Identyfikatory obiektów używane przez strony i elementy stron mają tę samą przestrzeń nazw.

Powroty

String – unikalny identyfikator obiektu,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getPageElementType()

Zwraca typ elementu strony (wyliczenie PageElementType).

Powroty

PageElementType – typ elementu strony.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getParentGroup()

Zwraca grupę, do której należy ten element strony, lub null, jeśli element nie należy do grupy.

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getParentPage()

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

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getParentPlaceholder()

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

Powroty

PageElement – nadrzędny element strony danego obiektu zastępczego obrazu lub null, jeśli obraz nie jest symbolem zastępczym lub nie ma elementu nadrzędnego.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getPlaceholderIndex()

Zwraca indeks obrazu zastępczego. Jeśli dwa lub więcej obrazów zastępczych na tej samej stronie jest tego samego typu, każdy z nich ma unikalną wartość indeksu. Zwraca wartość null, jeśli obraz nie jest symbolem zastępczym.

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getPlaceholderType()

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

Powroty

PlaceholderType – typ symbolu zastępczego danego obrazu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getRotation()

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

Powroty

Number – kąt obrotu w stopniach między 0 (włącznie) a 360 (bez tej wartości).

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getSourceUrl()

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

Jeśli obraz został wstawiony za pomocą adresu URL, zwraca adres URL podany podczas wstawiania obrazu.

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getTitle()

Zwraca tytuł tekstu alternatywnego elementu strony. Tytuł jest łączony z opisem, aby wyświetlić i odczytać tekst alternatywny.

Powroty

String – tytuł tekstu alternatywnego elementu strony.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getTop()

Pobiera pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został obracany.

Powroty

Number – położenie tego elementu w pionie (w punktach) od lewego górnego rogu strony.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getTransform()

Zwraca przekształcenie elementu strony.

Wygląd elementu strony zależy od jego bezwzględnego przekształcenia. Aby obliczyć przekształcenie bezwzględne, połącz wstępnie przekształcenie elementu strony z przekształceniami wszystkich jego grup nadrzędnych. Jeśli element strony nie należy do grupy, jego przekształcenie bezwzględne jest takie samo jak wartość w tym polu.

Powroty

AffineTransform – przekształcenie elementu strony.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getWidth()

Zwraca szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

preconcatenateTransform(transform)

Wstępnie łączy podane przekształcenie z istniejącym przekształceniem elementu strony.

newTransform = argument * existingTransform

Aby na przykład przenieść elementy strony o 36 punktów w lewo:

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

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

Parametry

NazwaTypOpis
transformAffineTransformTransformacja, która ma zostać wstępnie połączona z przekształceniem tego elementu strony.

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

remove()

Usuwa element strony.

Jeśli po operacji usuwania element Group zawiera tylko jeden element strony lub nie zawiera go wcale, sama grupa również jest usuwana.

Jeśli z obiektu głównego lub układu zostanie usunięty obiekt zastępczy PageElement, wszystkie puste dziedziczące symbole zastępcze też zostaną usunięte.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Usuwa: Link.

shape.removeLink();

replace(blobSource)

Zastępuje ten obraz obrazem opisanym przez obiekt BlobSource.

Wstawienie obrazu powoduje jednorazowe pobranie go z BlobSource i zapisanie kopii do wyświetlenia w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także muszą być w formacie PNG, JPEG lub GIF.

Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z rozmiarem istniejącego obrazu.

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

Parametry

NazwaTypOpis
blobSourceBlobSourceDane obrazu.

Powroty

Image – ten Image po wymianie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

replace(blobSource, crop)

Zastępuje ten obraz obrazem opisanym przez obiekt Image, opcjonalnie przycinając go, aby pasował.

Wstawienie obrazu powoduje jednorazowe pobranie go z BlobSource i zapisanie kopii do wyświetlenia w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także muszą być w formacie PNG, JPEG lub GIF.

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

NazwaTypOpis
blobSourceBlobSourceDane obrazu.
cropBooleanJeśli wybierzesz true, obraz zostanie przycięty do rozmiaru istniejącego. W przeciwnym razie obraz zostanie przeskalowany i wyśrodkowany.

Powroty

Image – ten Image po wymianie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

replace(imageUrl)

Zastępuje ten obraz innym obrazem pobranym z podanego adresu URL.

Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL, a jego kopia zostaje zapisana i wyświetlana w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także format PNG, JPEG lub GIF.

Podany adres URL musi być publicznie dostępny, a jego rozmiar nie może przekraczać 2 KB. Adres URL jest zapisywany wraz z obrazem i wyświetlany w elemencie getSourceUrl().

Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z rozmiarem istniejącego obrazu.

Parametry

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

Powroty

Image – ten Image po wymianie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

replace(imageUrl, crop)

Zastępuje ten obraz innym obrazem pobranym z podanego adresu URL, opcjonalnie przycinając go, aby go dopasować.

Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL, a jego kopia zostaje zapisana i wyświetlana w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także format PNG, JPEG lub GIF.

Podany adres URL nie może być większy niż 2 kB.

Parametry

NazwaTypOpis
imageUrlStringAdres URL, z którego można pobrać obraz.
cropBooleanJeśli wybierzesz true, obraz zostanie przycięty do rozmiaru istniejącego. W przeciwnym razie obraz zostanie przeskalowany i wyśrodkowany.

Powroty

Image – ten Image po wymianie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

scaleHeight(ratio)

Skaluje wysokość elementu o określony współczynnik. Wysokość elementu to wysokość jego ramki ograniczającej, gdy element nie podlega obracaniu.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.

Parametry

NazwaTypOpis
ratioNumberWspółczynnik skalowania wysokości tego elementu strony.

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

scaleWidth(ratio)

Skaluje szerokość elementu o określony współczynnik. Szerokość elementu to szerokość jego ramki ograniczającej, gdy element nie podlega obracaniu.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.

Parametry

NazwaTypOpis
ratioNumberWspółczynnik skalowania szerokości tego elementu strony.

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

select()

Zaznacza tylko element PageElement w aktywnej prezentacji i usuwa wszystkie wcześniejsze zaznaczenie. Ta funkcja działa tak samo jak wywołanie select(replace) w aplikacji true.

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

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

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

select(replace)

Zaznacza PageElement w aktywnej prezentacji.

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

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

Przekazuj false, aby wybrać wiele obiektów PageElement. Obiekty PageElement muszą być w tej samej wartości Page.

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

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

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

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

Parametry

NazwaTypOpis
replaceBooleanJeśli ustawiona jest wartość true, wybór zastępuje dowolny wcześniej wybrany. W przeciwnym razie wybrany element zostanie dodany do dowolnego z wcześniejszych elementów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

sendBackward()

Przesuwa element strony o jeden element wstecz.

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

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

sendToBack()

Przenosi element strony na jej tył.

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

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setDescription(description)

Ustawia alternatywny opis tekstu elementu strony.

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

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

Parametry

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

Powroty

Image – ten element strony.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setHeight(height)

Ustawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie podlega obracaniu.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.

Parametry

NazwaTypOpis
heightNumberNowa wysokość tego elementu strony do ustawienia (w punktach).

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setLeft(left)

Ustawia pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie podlega obracaniu.

Parametry

NazwaTypOpis
leftNumberNowa pozycja w poziomie do ustawienia w punktach.

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setLinkSlide(slideIndex)

Ustawia w polu Link wartość Slide przy użyciu indeksu slajdu liczonego od zera.

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

Parametry

NazwaTypOpis
slideIndexIntegerIndeks liczony od zera dla slajdu.

Powroty

Link – ustawiona wartość Link,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setLinkSlide(slide)

Ustawia w polu Link wartość Slide. Link jest ustawiany przez podany identyfikator slajdu.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Parametry

NazwaTypOpis
slideSlideSlide do połączenia.

Powroty

Link – ustawiona wartość Link,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setLinkSlide(slidePosition)

Ustawia element Link na Slide przy użyciu względnego położenia slajdu.

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

Parametry

NazwaTypOpis
slidePositionSlidePositionWzględny SlidePosition.

Powroty

Link – ustawiona wartość Link,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setLinkUrl(url)

Ustawia Link na podany niepusty ciąg adresu URL.

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

Parametry

NazwaTypOpis
urlStringCiąg adresu URL.

Powroty

Link – ustawiona wartość Link,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setRotation(angle)

Ustawia kąt obrotu elementu wokół jego środka w prawo w stopniach.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.

Parametry

NazwaTypOpis
angleNumberNowy kąt obrotu w prawo (w stopniach).

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setTitle(title)

Ustawia tytuł tekstu alternatywnego elementu strony.

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

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

Parametry

NazwaTypOpis
titleStringCiąg, na który ma zostać ustawiony tytuł tekstu alternatywnego.

Powroty

Image – ten element strony.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setTop(top)

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

Parametry

NazwaTypOpis
topNumberNowa pozycja w pionie do ustawienia w punktach.

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setTransform(transform)

Ustawia przekształcenie elementu strony przy użyciu podanego przekształcenia.

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

Aktualizowanie przekształcenia elementu strony, który należy do grupy, powoduje tylko zmianę przekształcenia tego elementu strony – nie ma wpływu na przekształcenia tej grupy ani innych elementów strony w tej grupie.

Szczegółowe informacje o tym, jak przekształcenia wpływają na wygląd elementów strony, znajdziesz w sekcji getTransform().

Parametry

NazwaTypOpis
transformAffineTransformPrzekształcenie ustawione dla tego elementu strony.

Powroty

Image – element do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setWidth(width)

Ustawia szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycjonowania.

Parametry

NazwaTypOpis
widthNumberNowa szerokość tego elementu strony do ustawienia (w punktach).

Powroty

Image – ten element strony używany do tworzenia łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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