Class Image

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

PageElement reprezentujący obraz.

Metody

MetodaZwracany typKrótki opis
alignOnPage(alignmentPosition)ImageWyrównuje element do określonego miejsca na stronie.
bringForward()ImagePrzenosi element strony do przodu o jeden element.
bringToFront()ImageUmieszcza element strony na początku strony.
duplicate()PageElementZduplikowany 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 blob.
getBorder()BorderZwraca wartość Border obrazu.
getConnectionSites()ConnectionSite[]Zwraca listę elementów ConnectionSite w elemencie strony lub pustą listę, jeśli element strony nie zawiera żadnych witryn połączonych.
getContentUrl()StringPobiera adres URL obrazu.
getDescription()StringZwraca opis tekstowy elementu strony.
getHeight()NumberPobiera wysokość elementu w punktach, czyli wysokość ramki granicznej elementu, gdy element nie ma rotacji.
getInherentHeight()NumberZwraca nieodłączną wysokość elementu w punktach.
getInherentWidth()NumberZwraca nieodłączną szerokość elementu w punktach.
getLeft()NumberZwraca pozycję w poziomie w punktach, mierzoną od lewego górnego rogu strony, gdy element nie ma rotacji.
getLink()LinkZwraca wartość Link lub null, jeśli nie ma linku.
getObjectId()StringZwraca unikalny identyfikator tego obiektu.
getPageElementType()PageElementTypeZwraca typ elementu strony określony jako 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 element nadrzędny elementu zastępczego.
getPlaceholderIndex()IntegerZwraca indeks obrazu zastępczego.
getPlaceholderType()PlaceholderTypeZwraca obiekt zastępczy obrazu lub PlaceholderType.NONE, jeśli kształt nie jest obiektem zastępczym.
getRotation()NumberZwraca kąt obrotu elementu w prawo o stopnie w stopniach, gdzie zero 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ę w pionie w punktach, mierzoną od lewego górnego rogu strony, gdy element nie ma rotacji.
getTransform()AffineTransformZwraca przekształcenie elementu strony.
getWidth()NumberZwraca szerokość elementu w punktach, czyli szerokość pola ograniczenia elementu, gdy element nie ma obrotu.
preconcatenateTransform(transform)ImagePołącza podany przekształcenie z istniejącym przekształceniem elementu strony.
remove()voidUsuwa element strony.
removeLink()voidUsuwa Link.
replace(blobSource)ImageZastępuje ten obraz obrazem opisującym obiekt BlobSource.
replace(blobSource, crop)ImageZastępuje ten obraz obrazem opisującym obiekt Image, opcjonalnie przycina obraz do rozmiaru.
replace(imageUrl)ImageZastępuje ten obraz innym obrazem pobranym z podanego adresu URL.
replace(imageUrl, crop)ImageZastępuje on inny obraz pobrany z podanego adresu URL, opcjonalnie przycinając obraz.
scaleHeight(ratio)ImageSkala wysokość elementu o określony współczynnik.
scaleWidth(ratio)ImageSkaluj szerokość elementu o określony współczynnik.
select()voidWybiera tylko PageElement w aktywnej prezentacji i usuwa poprzednie zaznaczenie.
select(replace)voidWybiera PageElement w aktywnej prezentacji.
sendBackward()ImageOdsyła element strony do tyłu o jeden element.
sendToBack()ImageWysyła element strony z tyłu strony.
setDescription(description)ImageUstawia opis tekstu elementu strony.
setHeight(height)ImageUstawia wysokość punktu w punktach, czyli wysokość ramki granicznej elementu, gdy element nie ma rotacji.
setLeft(left)ImageUstawia pozycję w punktach w punktach w punktach w lewym górnym rogu strony, gdy element nie ma obrotu.
setLinkSlide(slideIndex)LinkUstawia wartość Link dla danego elementu Slide za pomocą indeksu zerowego slajdu.
setLinkSlide(slide)LinkWskazuje wartość Link dla podanego parametru Slide. Link jest ustawiany przez podany identyfikator slajdu.
setLinkSlide(slidePosition)LinkUstawia wartość Link dla danego elementu Slide za pomocą względnej pozycji slajdu.
setLinkUrl(url)LinkUstawia w ciągu Link określony, niepusty ciąg URL.
setRotation(angle)ImageUstawia kąt obrotu elementu w prawo o stopnie 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 ma rotacji.
setTransform(transform)ImageUstawia przekształcenie elementu strony z podaną transformacją.
setWidth(width)ImageUstawia szerokość elementu w punktach (czyli szerokość pola ograniczenia elementu, gdy element nie ma obrotu).

Szczegółowa dokumentacja

alignOnPage(alignmentPosition)

Wyrównuje element do określonego miejsca na stronie.

Parametry

NazwaTypOpis
alignmentPositionAlignmentPositionPozycja wyrównania tego elementu strony na stronie.

Zwróć

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


bringForward()

Przenosi element strony do przodu o jeden element.

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

Zwróć

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

Autoryzacja

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

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

bringToFront()

Umieszcza element strony na początku strony.

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

Zwróć

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

Autoryzacja

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

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

duplicate()

Zduplikowany element strony.

Zduplikowany element strony jest umieszczony na tej samej stronie co strona pierwotna.

Zwróć

PageElement – nowy duplikat tego elementu strony.

Autoryzacja

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

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

getAs(contentType)

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „"myfile.pdf&quot”. Zakładamy jednak, że część nazwy pliku po ostatnim okresie (jeśli w ogóle) jest rozszerzeniem, które należy zastąpić. W związku z tym "ShoppingList.12.25.2014" zmienia się w "ShoppingList.12.25.pdf".

Aby sprawdzić dzienne limity konwersji, zobacz Limity usług Google. Nowo utworzone domeny Google Workspace mogą podlegać tymczasowym ograniczeniom.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma zostać przekonwertowane. W większości blobów 'application/pdf' jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowy jest też każdy z tych formatów: 'image/bmp', 'image/gif', 'image/jpeg' lub 'image/png'.

Zwróć

Blob – dane jako obiekt blob.


getBlob()

Zwraca dane wewnątrz obrazu jako blob.

Zwróć

Blob – dane obrazu jako blob.


getBorder()

Zwraca wartość Border obrazu.

Zwróć

Border – obramowanie obrazu.

Autoryzacja

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

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

getConnectionSites()

Zwraca listę elementów ConnectionSite w elemencie strony lub pustą listę, jeśli element strony nie zawiera żadnych witryn połączonych.

Zwróć

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

Autoryzacja

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

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

getContentUrl()

Pobiera adres URL obrazu.

Ten adres URL jest tagowany na koncie osoby wysyłającej żądanie, więc każda osoba mająca ten adres URL uzyskuje dostęp do obrazu jako osoby, która wysłała żądanie. Jeśli zmienią się ustawienia udostępniania prezentacji, dostęp do obrazu może zostać utracony. Zwrócony adres URL wygasa po krótkim czasie.

Zwróć

String

Autoryzacja

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

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

getDescription()

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

Zwróć

String – element tekstu strony w elemencie alternatywnym

Autoryzacja

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

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

getHeight()

Pobiera wysokość elementu w punktach, czyli wysokość ramki granicznej elementu, gdy element nie ma rotacji.

Zwróć

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

Autoryzacja

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

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

getInherentHeight()

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

Przekształcenie elementu strony jest względem niestandardowego rozmiaru. Aby określić końcowy wygląd elementu, użyj przekształconego rozmiaru w połączeniu z przekształceniem elementu.

Zwróć

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

Autoryzacja

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

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

getInherentWidth()

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

Przekształcenie elementu strony jest względem niestandardowego rozmiaru. Aby określić końcowy wygląd elementu, użyj przekształconego rozmiaru w połączeniu z przekształceniem elementu.

Zwróć

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

Autoryzacja

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

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

getLeft()

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

Zwróć

Number – pozycja pozioma tego punktu w lewym górnym rogu strony,

Autoryzacja

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

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

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

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

Zwróć

Link

Autoryzacja

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

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

getObjectId()

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

Zwróć

String – unikalny identyfikator tego obiektu,

Autoryzacja

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

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

getPageElementType()

Zwraca typ elementu strony określony jako wyliczenie PageElementType.

Zwróć

PageElementType – typ elementu strony.

Autoryzacja

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

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

getParentGroup()

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

Zwróć

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

Autoryzacja

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

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

getParentPage()

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

Zwróć

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

Autoryzacja

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

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

getParentPlaceholder()

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

Zwróć

PageElement – element strony nadrzędnej tego obiektu zastępczego albo null, jeśli ten obraz nie jest obiektem zastępczym lub nie ma elementu nadrzędnego.

Autoryzacja

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

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

getPlaceholderIndex()

Zwraca indeks obrazu zastępczego. Jeśli co najmniej 2 obrazy zastępcze na tej samej stronie mają ten sam typ, każdy z nich ma unikalną wartość indeksu. Zwraca wartość null, jeśli obraz jest znakiem zastępczym.

Zwróć

Integer – indeks obrazu lub null, jeśli nie jest to obiekt zastępczy.

Autoryzacja

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

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

getPlaceholderType()

Zwraca obiekt zastępczy obrazu lub PlaceholderType.NONE, jeśli kształt nie jest obiektem zastępczym.

Zwróć

PlaceholderType – typ obiektu zastępczego obrazu.

Autoryzacja

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

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

getRotation()

Zwraca kąt obrotu elementu w prawo o stopnie w stopniach, gdzie zero stopni oznacza brak obrotu.

Zwróć

Number – kąt obrotu między 0 (włącznie) a 360 (wyłącznie).

Autoryzacja

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

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

getSourceUrl()

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

Obraz zostaje wstawiony przez URL, więc zwraca adres URL podany podczas wstawiania obrazu.

Zwróć

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

Autoryzacja

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

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

getTitle()

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

Zwróć

String – tytuł tekstu alternatywnego elementu strony.

Autoryzacja

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

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

getTop()

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

Zwróć

Number – pionowa pozycja tego elementu w punktach, w lewym górnym rogu strony.

Autoryzacja

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

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

getTransform()

Zwraca przekształcenie elementu strony.

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

Zwróć

AffineTransform – przekształcenie elementu strony.

Autoryzacja

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

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

getWidth()

Zwraca szerokość elementu w punktach, czyli szerokość pola ograniczenia elementu, gdy element nie ma obrotu.

Zwróć

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

Autoryzacja

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

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

preconcatenateTransform(transform)

Połącza podany przekształcenie z istniejącym przekształceniem elementu strony.

newTransform = argument * existingTransform

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

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

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

Parametry

NazwaTypOpis
transformAffineTransformPrzekształcenie, które spowoduje dopasowanie do przekształcenia tego elementu strony.

Zwróć

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

Autoryzacja

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

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

remove()

Usuwa element strony.

Jeśli po usunięciu linku Group zawiera tylko 1 element strony lub nie ma go wcale, również grupa zostanie usunięta.

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

Autoryzacja

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

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

Usuwa Link.

shape.removeLink();

replace(blobSource)

Zastępuje ten obraz obrazem opisującym obiekt BlobSource.

Wstawianie obrazu powoduje pobranie go z BlobSource, a jego kopia jest przechowywana do wyświetlania w prezentacji. Obrazy muszą być mniejsze niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.

Aby zachować współczynnik proporcji obrazu, zostaje on przeskalowany i wyśrodkowany względem rozmiaru istniejącego obrazu.

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

Parametry

NazwaTypOpis
blobSourceBlobSourceDane obrazu.

Zwróć

Image – ten Image po zamianie.

Autoryzacja

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

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

replace(blobSource, crop)

Zastępuje ten obraz obrazem opisującym obiekt Image, opcjonalnie przycina obraz do rozmiaru.

Wstawianie obrazu powoduje pobranie go z BlobSource, a jego kopia jest przechowywana do wyświetlania w prezentacji. Obrazy muszą być mniejsze niż 50 MB, nie mogą przekraczać 25 megapikseli i 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 zasada true ma zostać przycięta, dopasowuje obraz do istniejącego rozmiaru. W przeciwnym razie obraz jest skalowany i wyśrodkowany.

Zwróć

Image – ten Image po zamianie.

Autoryzacja

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

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

replace(imageUrl)

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

Wstawianie obrazu jest pobierane raz z adresu URL, a kopia jest przechowywana na potrzeby prezentacji. Obrazy muszą być mniejsze niż 50 MB, nie mogą przekraczać 25 megapikseli i być w formacie PNG, JPEG lub GIF.

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

Aby zachować współczynnik proporcji obrazu, zostaje on przeskalowany i wyśrodkowany względem rozmiaru istniejącego obrazu.

Parametry

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

Zwróć

Image – ten Image po zamianie.

Autoryzacja

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

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

replace(imageUrl, crop)

Zastępuje on inny obraz pobrany z podanego adresu URL, opcjonalnie przycinając obraz.

Wstawianie obrazu jest pobierane raz z adresu URL, a kopia jest przechowywana na potrzeby prezentacji. Obrazy muszą być mniejsze niż 50 MB, nie mogą przekraczać 25 megapikseli i 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 zasada true ma zostać przycięta, dopasowuje obraz do istniejącego rozmiaru. W przeciwnym razie obraz jest skalowany i wyśrodkowany.

Zwróć

Image – ten Image po zamianie.

Autoryzacja

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

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

scaleHeight(ratio)

Skala wysokość elementu o określony współczynnik. Wysokość elementu to wysokość jego ramki granicznej, jeśli element nie ma rotacji.

Parametry

NazwaTypOpis
ratioNumberStosunek skalowania tego elementu strony do wysokości.

Zwróć

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

Autoryzacja

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

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

scaleWidth(ratio)

Skaluj szerokość elementu o określony współczynnik. Szerokość elementu to szerokość jego ramki granicznej, jeśli element nie ma obrotu.

Parametry

NazwaTypOpis
ratioNumberStosunek skalowania tego elementu strony do szerokości.

Zwróć

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

Autoryzacja

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

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

select()

Wybiera tylko PageElement w aktywnej prezentacji i usuwa poprzednie zaznaczenie. Przypomina to połączenie z numerem select(replace) przy użyciu true.

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

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

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

Autoryzacja

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

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

select(replace)

Wybiera PageElement w aktywnej prezentacji.

Skrypt ma dostęp tylko do zaznaczenia 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ąć wcześniejszy wybór. Spowoduje to też ustawienie elementu nadrzędnego Page elementu PageElement jako current page selection.

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

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

  1. Nadrzędny element Page obiektu PageElement musi być wartością current page selection.
  2. Nie powinno być wybranych wielu obiektów Page.

Aby mieć pewność, że tak właśnie jest w Twoim przypadku, najpierw wybierz nadrzędny element Page za pomocą atrybutu Page.selectAsCurrentPage(), a następnie 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 wybierzesz element true, wybór zastąpi wcześniejszy wybór. W przeciwnym razie wybór zostanie dodany do wszystkich poprzednich wyborów.

Autoryzacja

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

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

sendBackward()

Odsyła element strony do tyłu o jeden element.

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

Zwróć

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

Autoryzacja

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

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

sendToBack()

Wysyła element strony z tyłu strony.

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

Zwróć

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

Autoryzacja

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

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

setDescription(description)

Ustawia 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 znaków, do którego ma być ustawiony opis alternatywny.

Zwróć

Image – ten element strony.

Autoryzacja

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

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

setHeight(height)

Ustawia wysokość punktu w punktach, czyli wysokość ramki granicznej elementu, gdy element nie ma rotacji.

Parametry

NazwaTypOpis
heightNumberNowa wysokość elementu strony, który ma zostać ustawiony (w punktach).

Zwróć

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

Autoryzacja

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

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

setLeft(left)

Ustawia pozycję w punktach w punktach w punktach w lewym górnym rogu strony, gdy element nie ma obrotu.

Parametry

NazwaTypOpis
leftNumberNowa pozycja pozioma do ustawienia w punktach.

Zwróć

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

Autoryzacja

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

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

setLinkSlide(slideIndex)

Ustawia wartość Link dla danego elementu Slide za pomocą indeksu zerowego slajdu.

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

Parametry

NazwaTypOpis
slideIndexIntegerIndeks zawierający zero.

Zwróć

LinkLink, który został ustawiony.

Autoryzacja

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

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

setLinkSlide(slide)

Wskazuje wartość Link dla podanego parametru 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.

Zwróć

LinkLink, który został ustawiony.

Autoryzacja

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

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

setLinkSlide(slidePosition)

Ustawia wartość Link dla danego elementu Slide za pomocą względnej pozycji slajdu.

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

Parametry

NazwaTypOpis
slidePositionSlidePositionWzględny SlidePosition.

Zwróć

LinkLink, który został ustawiony.

Autoryzacja

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

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

setLinkUrl(url)

Ustawia w ciągu Link określony, niepusty ciąg URL.

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

Parametry

NazwaTypOpis
urlStringCiąg adresu URL.

Zwróć

LinkLink, który został ustawiony.

Autoryzacja

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

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

setRotation(angle)

Ustawia kąt obrotu elementu w prawo o stopnie w stopniach.

Parametry

NazwaTypOpis
angleNumberNowy kąt obrotu w prawo, który chcesz ustawić.

Zwróć

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

Autoryzacja

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

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

setTitle(title)

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

Zwróć

Image – ten element strony.

Autoryzacja

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

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

setTop(top)

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

Parametry

NazwaTypOpis
topNumberNowa pozycja pionowa do ustawienia w punktach.

Zwróć

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

Autoryzacja

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

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

setTransform(transform)

Ustawia przekształcenie elementu strony z podaną transformacją.

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

Zaktualizowanie przekształcenia elementu strony należącego do grupy zmienia tylko przekształcenie tego elementu. Nie wpływa to na przekształcenie grupy ani innych elementów strony w grupie.

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

Parametry

NazwaTypOpis
transformAffineTransformPrzekształcenie ustawione dla tego elementu strony.

Zwróć

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

Autoryzacja

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

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

setWidth(width)

Ustawia szerokość elementu w punktach (czyli szerokość pola ograniczenia elementu, gdy element nie ma obrotu).

Parametry

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

Zwróć

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

Autoryzacja

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

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