Class PageElement

PageElement

Element wizualny renderowany na stronie.

Metody

MetodaZwracany typKrótki opis
alignOnPage(alignmentPosition)PageElementWyrównuje element do określonego położenia wyrównania na stronie.
asGroup()GroupZwraca element strony jako grupę.
asImage()ImageZwraca element strony jako obraz.
asLine()LineZwraca element strony w postaci linii.
asShape()ShapeZwraca element strony jako kształt.
asSheetsChart()SheetsChartZwraca element strony jako połączony wykres umieszczony w Arkuszach Google.
asTable()TableZwraca element strony jako tabelę.
asVideo()VideoZwraca element strony jako film.
asWordArt()WordArtZwraca element strony jako obiekt WordArt.
bringForward()PageElementPrzesuwa element strony do przodu o jeden element.
bringToFront()PageElementPrzenosi element strony na początek.
duplicate()PageElementPowiela element strony.
getConnectionSites()ConnectionSite[]Zwraca listę ConnectionSite w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn łączących.
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.
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.
getRotation()NumberZwraca kąt obrotu elementu w prawo wokół jego środka wyrażony w stopniach, gdzie 0 stopni oznacza brak obrotu.
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)PageElementWstępnie łączy podane przekształcenie z istniejącym przekształceniem elementu strony.
remove()voidUsuwa element strony.
scaleHeight(ratio)PageElementSkaluje wysokość elementu o określony współczynnik.
scaleWidth(ratio)PageElementSkaluje 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()PageElementPrzesuwa element strony o jeden element wstecz.
sendToBack()PageElementPrzenosi element strony na jej tył.
setDescription(description)PageElementUstawia alternatywny opis tekstu elementu strony.
setHeight(height)PageElementUstawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie podlega obracaniu.
setLeft(left)PageElementUstawia pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie podlega obracaniu.
setRotation(angle)PageElementUstawia kąt obrotu elementu wokół jego środka w prawo w stopniach.
setTitle(title)PageElementUstawia tytuł tekstu alternatywnego elementu strony.
setTop(top)PageElementUstawia pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie jest obracany.
setTransform(transform)PageElementUstawia przekształcenie elementu strony przy użyciu podanego przekształcenia.
setWidth(width)PageElementUstawia 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

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


asGroup()

Zwraca element strony jako grupę.

Powroty

Group – ten element strony jako grupa.

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

asImage()

Zwraca element strony jako obraz.

Powroty

Image – ten element strony jest obrazem.

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

asLine()

Zwraca element strony w postaci linii.

Powroty

Line – ten element strony ma postać linii.

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

asShape()

Zwraca element strony jako kształt.

Powroty

Shape – ten element strony w postaci kształtu.

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

asSheetsChart()

Zwraca element strony jako połączony wykres umieszczony w Arkuszach Google.

Powroty

SheetsChart – element strony mający postać wykresu.

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

asTable()

Zwraca element strony jako tabelę.

Powroty

Table – ten element strony jest tabelą.

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

asVideo()

Zwraca element strony jako film.

Powroty

Video – ten element strony jest filmem.

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

asWordArt()

Zwraca element strony jako obiekt WordArt.

Powroty

WordArt – ten element strony jako tekst WordArt.

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

bringForward()

Przesuwa element strony do przodu o jeden element.

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

Powroty

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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