Class Image

Obraz

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 o jeden element do przodu.
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()BlobZwraca dane wewnątrz obrazu jako obiekt blob.
getBorder()BorderZwraca Border obrazu.
getConnectionSites()ConnectionSite[]Zwraca listę elementów ConnectionSite w elemencie strony lub pustą listę, jeśli strona z elementem nie ma żadnych połączonych stron.
getContentUrl()StringPobiera adres URL obrazu.
getDescription()StringZwraca opis tekstowy elementu strony.
getHeight()NumberPobiera wysokość elementu w punktach, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji.
getInherentHeight()NumberZwraca nieodłączną wysokość elementu podaną w punktach.
getInherentWidth()NumberZwraca nieodłączną szerokość elementu w punktach.
getLeft()NumberZwraca w punktach pozycję poziomą elementu mierzoną od lewego górnego rogu elementu strony, gdy element nie ma rotacji.
getLink()LinkZwraca Link lub null, jeśli nie ma linku.
getObjectId()StringZwraca unikalny identyfikator obiektu.
getPageElementType()PageElementTypeZwraca typ elementu strony reprezentowany jako wyliczenie PageElementType.
getParentGroup()GroupZwraca grupę, do której należy ten element strony, lub null, jeśli element nie znajduje się w grupy reklam.
getParentPage()PageZwraca stronę, na której znajduje się ten element strony.
getParentPlaceholder()PageElementZwraca nadrzędny element strony dla obiektu zastępczego.
getPlaceholderIndex()IntegerZwraca indeks obrazu zastępczego.
getPlaceholderType()PlaceholderTypeZwraca typ obiektu zastępczego obrazu lub PlaceholderType.NONE, jeśli kształt nie jest odpowiedni obiekt zastępczy.
getRotation()NumberZwraca kąt obrotu elementu w prawo wokół jego środka, gdzie 0 stopni oznacza brak rotacji.
getSourceUrl()StringPobiera źródłowy adres URL obrazu, jeśli jest dostępny.
getTitle()StringZwraca tytuł tekstu alternatywnego elementu strony.
getTop()NumberPobiera pionową pozycję elementu w punktach zmierzoną od lewego górnego rogu strony gdy element nie ma rotacji.
getTransform()AffineTransformZwraca przekształcenie elementu strony.
getWidth()NumberZwraca szerokość elementu w punktach, która jest szerokością ramki ograniczającej elementu, gdy element nie ma rotacji.
preconcatenateTransform(transform)ImageWstępnie łączy podane przekształcenie z istniejącym przekształceniem elementu strony.
remove()voidUsuwa element strony.
removeLink()voidUsuwa element 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 obrazu.
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 obrazu.
scaleHeight(ratio)ImageSkaluje wysokość elementu według określonego współczynnika.
scaleWidth(ratio)ImageSkaluje szerokość elementu według określonego współczynnika.
select()voidWybiera tylko element PageElement w aktywnej prezentacji i usuwa wszystkie poprzednie wyboru.
select(replace)voidWybiera element PageElement w aktywnej prezentacji.
sendBackward()ImagePrzesuwa element strony o jeden element wstecz.
sendToBack()ImagePrzesuwa element strony na tylną część strony.
setDescription(description)ImageUstawia tekst alternatywny elementu strony.
setHeight(height)ImageUstawia wysokość elementu w punktach, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji.
setLeft(left)ImageOkreśla pozycję elementu w poziomie w punktach, mierzoną od lewego górnego rogu elementu strony, gdy element nie ma rotacji.
setLinkSlide(slideIndex)LinkUstawia Link na podaną wartość Slide za pomocą indeksu slajdu liczony od zera.
setLinkSlide(slide)LinkUstawia element Link na podany element Slide, a link jest ustawiany przez podany identyfikator slajdu.
setLinkSlide(slidePosition)LinkUstawia Link na podaną wartość Slide na podstawie względnej pozycji slajdu.
setLinkUrl(url)LinkUstawia wartość Link na dany ciąg znaków adresu URL, który nie jest pusty.
setRotation(angle)ImageUstawia kąt obrotu elementu w prawo dookoła jego środka (w stopniach).
setTitle(title)ImageUstawia tytuł tekstu alternatywnego elementu strony.
setTop(top)ImageOkreśla pozycję elementu w pionie w punktach, zmierzoną od lewego górnego rogu strony gdy element nie ma rotacji.
setTransform(transform)ImageUstawia przekształcenie elementu strony za pomocą podanego przekształcenia.
setWidth(width)ImageUstawia szerokość elementu w punktach, która jest szerokością ramki ograniczającej elementu, gdy Element nie ma rotacji.

Szczegółowa dokumentacja

alignOnPage(alignmentPosition)

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

Parametry

NazwaTypOpis
alignmentPositionAlignmentPositionPołożenie, do którego ma zostać wyrównany ten element strony.

Powrót

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


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żący do tworzenia łańcuchów.

Autoryzacja

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.

Powrót

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

Autoryzacja

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 umieszczany na tej samej stronie i w tym samym położeniu co oryginał.

Powrót

PageElement – nowy duplikat tego elementu strony.

Autoryzacja

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. Ten dodaje do nazwy pliku odpowiednie rozszerzenie – na przykład „mojplik.pdf”. Jednak zakłada, że część nazwy pliku, która następuje po ostatnim kropce (jeśli występuje), jest już , które należy zastąpić. W rezultacie „ShoppingList.12.25.2014” zmienia się w „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zobacz Limity dla Google Usługi. Nowo utworzone domeny Google Workspace mogą być tymczasowo bardziej rygorystyczne limity.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME do skonwertowania. W przypadku większości blobów atrybut 'application/pdf' to jedyną prawidłową opcją. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG możesz też użyć dowolnej z tych wartości: 'image/bmp', 'image/gif', 'image/jpeg' lub 'image/png'. prawidłowe. W przypadku dokumentów w Dokumentach Google prawidłowa jest też wartość 'text/markdown'.

Powrót

Blob – dane w postaci obiektu blob.


getBlob()

Zwraca dane wewnątrz obrazu jako obiekt blob.

Powrót

Blob – dane obrazu w postaci obiektu blob.


getBorder()

Zwraca wartość Border obrazu.

Powrót

Border – obramowanie obrazu.

Autoryzacja

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ę elementów ConnectionSite w elemencie strony lub pustą listę, jeśli strona z elementem nie ma żadnych połączonych stron.

Powrót

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

Autoryzacja

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.

Ten adres URL jest otagowany kontem osoby wysyłającej prośbę, więc każda osoba, która posiada ten adres URL, uzyskuje dostęp do zdjęcia jako osoba, która zgłosiła pierwotne żądanie. Dostęp do obrazu może zostać utracony, jeśli ustawienia udostępniania prezentacji. Zwrócony adres URL wygasa po krótkim czasie.

Powrót

String

Autoryzacja

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 tekstowy elementu strony. Opis jest połączony z tytułem wyświetlania i odczytywania tekstu alternatywnego.

Powrót

String – opis tekstu alternatywnego elementu strony.

Autoryzacja

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, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Powrót

Number – nieodłączna wysokość elementu strony podana w punktach lub null, jeśli element strony ma tak nie mają wysokości.

Autoryzacja

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 nieodłączną wysokość elementu podaną w punktach.

Przekształcenie elementu strony zależy od jego rozmiaru. Używaj właściwego rozmiaru w wraz z przekształceniem elementu, aby określić jego ostateczny wygląd.

Powrót

Number – nieodłączna wysokość elementu strony podana w punktach lub null, jeśli element strony ma tak nie mają wysokości.

Autoryzacja

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 rozmiaru. Używaj właściwego rozmiaru w wraz z przekształceniem elementu, aby określić jego ostateczny wygląd.

Powrót

Number – maksymalna szerokość elementu strony podana w punktach lub null, jeśli element strony ma tak nie mają szerokości.

Autoryzacja

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 w punktach pozycję poziomą elementu mierzoną od lewego górnego rogu elementu strony, gdy element nie ma rotacji.

Powrót

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

Autoryzacja

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 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());
}

Powrót

Link

Autoryzacja

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 obiektu. Identyfikatory obiektów używane przez strony i ich elementy mają ten sam identyfikator w tej samej przestrzeni nazw.

Powrót

String – unikalny identyfikator obiektu.

Autoryzacja

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 reprezentowany jako wyliczenie PageElementType.

Powrót

PageElementType – typ elementu strony.

Autoryzacja

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 znajduje się w grupy reklam.

Powrót

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

Autoryzacja

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.

Powrót

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

Autoryzacja

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 dla obiektu zastępczego. Zwraca wartość null, jeśli obraz nie jest zastępczego lub bez elementu nadrzędnego.

Powrót

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

Autoryzacja

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 co najmniej 2 obrazy zastępcze na tej samej stronie są tego samego typu, mają unikalną wartość indeksu Zwraca wartość null, jeśli obraz nie jest obiekt zastępczy.

Powrót

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

Autoryzacja

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 obiektu zastępczego obrazu lub PlaceholderType.NONE, jeśli kształt nie jest odpowiedni obiekt zastępczy.

Powrót

PlaceholderType – typ obiektu zastępczego obrazu.

Autoryzacja

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, gdzie 0 stopni oznacza brak rotacji.

Powrót

Number – kąt obrotu w stopniach od 0 (włącznie) do 360 (bez tej wartości).

Autoryzacja

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.

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

Powrót

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

Autoryzacja

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 połączony z opisem, aby wyświetlania i odczytywania tekstu alternatywnego.

Powrót

String – tytuł tekstu alternatywnego elementu strony.

Autoryzacja

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 pionową pozycję elementu w punktach zmierzoną od lewego górnego rogu strony gdy element nie ma rotacji.

Powrót

Number – położenie tego elementu w pionie w punktach w lewym górnym rogu strony.

Autoryzacja

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 przekształcenia bezwzględnego. Do obliczanie przekształcenia bezwzględnego, wstępne łączenie przekształcenia elementu strony z przekształceniami wszystkich swoich grup nadrzędnych. Jeśli element strony nie należy do grupy, jego przekształcenie bezwzględne ma postać taka sama jak wartość w tym polu.

Powrót

AffineTransform – przekształcenie elementu strony.

Autoryzacja

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, która jest szerokością ramki ograniczającej elementu, gdy element nie ma rotacji.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Powrót

Number – maksymalna szerokość elementu strony podana w punktach lub null, jeśli element strony ma tak nie mają szerokości.

Autoryzacja

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 np. 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 funkcją setTransform(transform).

Parametry

NazwaTypOpis
transformAffineTransformPrzekształcenie, które zostanie wstępnie powiązane z przekształceniem tego elementu strony.

Powrót

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

Autoryzacja

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, w parametrze samej grupy zostanie również usunięta.

Jeśli obiekt zastępczy PageElement zostanie usunięty z elementu głównego lub układu, wszystkie puste elementy dziedziczenia zmienne również są usuwane.

Autoryzacja

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

shape.removeLink();

replace(blobSource)

Zastępuje ten obraz obrazem opisanym przez obiekt BlobSource.

Wstawienie obrazu spowoduje jego pobranie z BlobSource, a kopia zostanie zapisana w prezentacji. Zdjęcia muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w jednym Format PNG, JPEG lub GIF.

Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z założeniami do 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

NazwaTypOpis
blobSourceBlobSourceDane obrazu.

Powrót

ImageImage po wymianie.

Autoryzacja

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

Wstawienie obrazu spowoduje jego pobranie z BlobSource, a kopia zostanie zapisana w prezentacji. Zdjęcia muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w jednym Format 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.
cropBooleanW przypadku opcji true obraz zostanie przycięty, aby pasował do rozmiaru istniejącego obrazu. W przeciwnym razie obraz jest przeskalowany i wyśrodkowany.

Powrót

ImageImage po wymianie.

Autoryzacja

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 jego pobranie z adresu URL tylko raz, a jego kopia jest zapisywana w celu wyświetlenia prezentacji. Rozmiar zdjęć nie może przekraczać 50 MB, nie może przekraczać 25 megapikseli. być w formacie PNG, JPEG lub GIF.

Podany adres URL musi być publicznie dostępny i nie może być większy niż 2 kB. Sam URL jest zapisywany i udostępniany za pomocą getSourceUrl().

Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z założeniami do rozmiaru istniejącego obrazu.

Parametry

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

Powrót

ImageImage po wymianie.

Autoryzacja

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

Wstawienie obrazu powoduje jego pobranie z adresu URL tylko raz, a jego kopia jest zapisywana w celu wyświetlenia prezentacji. Rozmiar zdjęć nie może przekraczać 50 MB, nie może przekraczać 25 megapikseli. 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.
cropBooleanW przypadku opcji true obraz zostanie przycięty, aby pasował do rozmiaru istniejącego obrazu. W przeciwnym razie obraz jest przeskalowany i wyśrodkowany.

Powrót

ImageImage po wymianie.

Autoryzacja

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 według określonego współczynnika. Wysokość elementu to wysokość jego ramkę ograniczającą, gdy element nie jest objęty obrotem.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Parametry

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

Powrót

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

Autoryzacja

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 według określonego współczynnika. Szerokość elementu to szerokość jego ramkę ograniczającą, gdy element nie jest objęty obrotem.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Parametry

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

Powrót

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

Autoryzacja

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

Wybiera tylko element PageElement w aktywnej prezentacji i usuwa wszystkie poprzednie wyboru. Ta funkcja działa tak samo, jak nawiązanie połączenia z numerem select(replace) w aplikacji true.

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

Ustawia nadrzędny Page elementu PageElement na 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();

Autoryzacja

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)

Wybiera element PageElement w aktywnej prezentacji.

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

Przekaż true do tej metody, aby wybrać tylko PageElement i usunąć pozostałe poprzedniego wyboru. Spowoduje to również ustawienie nadrzędnego Page obiektu PageElement jako current page selection

Aby wybrać kilka obiektów PageElement, miń false. PageElement obiekty muszą być w tym samym obiekcie Page.

Podczas wybierania elementu strony za pomocą false muszą być spełnione poniższe warunki :

  1. Elementem nadrzędnym Page obiektu PageElement musi być current page selection.
  2. Nie można zaznaczyć wielu obiektów Page.

Aby mieć pewność, że tak jest, najlepiej jest wybrać nadrzędny Page. najpierw za pomocą Page.selectAsCurrentPage(), a następnie wybierz 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 true, zastąpi dowolny poprzedni wybór; w przeciwnym razie zostanie dodany do wcześniejszego zaznaczenia.

Autoryzacja

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.

Powrót

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

Autoryzacja

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

Przesuwa element strony na tylną część strony.

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

Powrót

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

Autoryzacja

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

NazwaTypOpis
descriptionStringCiąg, dla którego ma zostać ustawiony tekst alternatywny opisu.

Powrót

Image – ten element strony.

Autoryzacja

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, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Parametry

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

Powrót

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

Autoryzacja

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)

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

Parametry

NazwaTypOpis
leftNumberNowa pozycja w poziomie do ustawienia (w punktach).

Powrót

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

Autoryzacja

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 Link na podaną wartość Slide za pomocą indeksu slajdu liczony od zera.

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

Parametry

NazwaTypOpis
slideIndexIntegerIndeks liczony od zera dla slajdu.

Powrót

LinkLink, który został ustawiony;

Autoryzacja

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 element Link na podany element Slide, a 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.

Powrót

LinkLink, który został ustawiony;

Autoryzacja

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 Link na podaną wartość Slide na podstawie względnej pozycji slajdu.

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

Parametry

NazwaTypOpis
slidePositionSlidePositionWzględna wartość SlidePosition.

Powrót

LinkLink, który został ustawiony;

Autoryzacja

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 wartość Link na dany ciąg znaków adresu URL, który nie jest pusty.

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

Parametry

NazwaTypOpis
urlStringCiąg adresu URL.

Powrót

LinkLink, który został ustawiony;

Autoryzacja

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 w prawo dookoła jego środka (w stopniach).

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Parametry

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

Powrót

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

Autoryzacja

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, dla którego należy ustawić tytuł tekstu alternatywnego.

Powrót

Image – ten element strony.

Autoryzacja

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)

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

Parametry

NazwaTypOpis
topNumberNowa pozycja w pionie do ustawienia (w punktach).

Powrót

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

Autoryzacja

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 za pomocą podanego przekształcenia.

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

Aktualizacja przekształcenia elementu strony, który należy do grupy, zmienia tylko przekształcenie ten element strony; Nie ma to wpływu na przekształcenia grupy ani innych elementów strony w grupy reklam.

Szczegółowe informacje na temat wpływu przekształceń na wygląd elementów strony znajdziesz na stronie getTransform().

Parametry

NazwaTypOpis
transformAffineTransformPrzekształcenie ustawione dla tego elementu strony.

Powrót

Image – ten element służy do tworzenia łańcuchów.

Autoryzacja

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, która jest szerokością ramki ograniczającej elementu, gdy Element nie ma rotacji.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Parametry

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

Powrót

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

Autoryzacja

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