Class Line

Linia

PageElement reprezentujący linię.

Metody

MetodaZwracany typKrótki opis
alignOnPage(alignmentPosition)LineWyrównuje element do określonej pozycji wyrównania na stronie.
bringForward()LinePrzesuwa element o jeden element w górę.
bringToFront()LinePrzesuwa element na wierzch strony.
duplicate()PageElementZduplikuje element strony.
getConnectionSites()ConnectionSite[]Zwraca listę ConnectionSite w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych miejsc połączenia.
getDashStyle()DashStylePobiera wartość DashStyle wiersza.
getDescription()StringZwraca opis tekstu alternatywnego elementu strony.
getEnd()PointZwraca punkt końcowy linii mierzony od lewego górnego rogu strony.
getEndArrow()ArrowStylePobiera ArrowStyle strzałki na końcu wiersza.
getEndConnection()ConnectionSiteZwraca połączenie na końcu wiersza lub null, jeśli nie ma połączenia.
getHeight()NumberPobiera wysokość elementu w punktach, czyli wysokość jego prostokąta ograniczającego, gdy nie jest on obracany.
getInherentHeight()NumberZwraca wbudowaną wysokość elementu w punktach.
getInherentWidth()NumberZwraca wbudowaną szerokość elementu w punktach.
getLeft()NumberZwraca poziomą pozycję elementu w punktach, mierząc od lewego górnego rogu strony, gdy element nie jest obracany.
getLineCategory()LineCategoryPobiera wartość LineCategory wiersza.
getLineFill()LineFillPobiera wartość LineFill wiersza.
getLineType()LineTypePobiera wartość LineType wiersza.
getLink()LinkZwraca wartość Link lub null, jeśli nie ma linku.
getObjectId()StringZwraca unikalny identyfikator tego obiektu.
getPageElementType()PageElementTypeZwraca typ elementu strony jako typ enumeracji PageElementType.
getParentGroup()GroupZwraca grupę, do której należy ten element strony, lub null, jeśli element nie należy do żadnej grupy.
getParentPage()PageZwraca stronę, na której znajduje się element strony.
getRotation()NumberZwraca kąt obrotu elementu wokół jego środka w stopniach, przy czym 0 stopni oznacza brak obrotu.
getStart()PointZwraca punkt początkowy linii, mierzony od lewego górnego rogu strony.
getStartArrow()ArrowStylePobiera ArrowStyle strzałki na początku wiersza.
getStartConnection()ConnectionSiteZwraca połączenie na początku wiersza lub null, jeśli nie ma połączenia.
getTitle()StringZwraca tytuł tekstu alternatywnego elementu strony.
getTop()NumberZwraca pionowe położenie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.
getTransform()AffineTransformZwraca transformację elementu strony.
getWeight()NumberZwraca grubość linii w punktach.
getWidth()NumberZwraca szerokość elementu w punktach, czyli szerokość jego prostokąta ograniczającego, gdy element nie jest obrócony.
isConnector()BooleanZwraca wartość true, jeśli linia jest łącznikiem, lub wartość false, jeśli nie.
preconcatenateTransform(transform)LinePrzekształca podany obiekt transformacji w istniejącą transformację elementu strony.
remove()voidUsuwa element strony.
removeLink()voidUsuwa Link.
reroute()LinePrzekierowuje początek i koniec linii do dwóch najbliższych miejsc połączenia w połączonych elementach strony.
scaleHeight(ratio)LineSkaluje wysokość elementu zgodnie z określonym współczynnikiem.
scaleWidth(ratio)LineSkaluje szerokość elementu według określonego współczynnika.
select()voidWybiera tylko PageElement w aktywnej prezentacji i usuwa wszystkie poprzednie zaznaczenia.
select(replace)voidWybiera PageElement w aktywnej prezentacji.
sendBackward()LinePrzesuwa element o jeden element w tył.
sendToBack()LinePrzesuwa element na końcu strony.
setDashStyle(style)LineUstawia DashStyle linii.
setDescription(description)LineUstawia tekst alternatywny elementu strony.
setEnd(left, top)LineUstawia pozycję punktu końcowego linii.
setEnd(point)LineUstawia pozycję punktu końcowego linii.
setEndArrow(style)LineUstawia ArrowStyle strzałki na końcu linii.
setEndConnection(connectionSite)LineUstawia połączenie na końcu linii.
setHeight(height)LineUstawia wysokość elementu w punktach, czyli wysokość jego prostokąta ograniczającego, gdy nie jest on obracany.
setLeft(left)LineUstawia położenie elementu w osi poziomej w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.
setLineCategory(lineCategory)LineUstawia LineCategory linii.
setLinkSlide(slideIndex)LinkUstawia wartość Link na podaną wartość Slide, używając indeksu liczonego od 0 na slajdzie.
setLinkSlide(slide)LinkUstawia Link na podanym Slide, a link jest ustawiany za pomocą podanego identyfikatora slajdu.
setLinkSlide(slidePosition)LinkUstawia Link na podanej wartości Slide, używając względnego położenia slajdu.
setLinkUrl(url)LinkUstawia Link na podany niepusty ciąg znaków adresu URL.
setRotation(angle)LineUstawia kąt obrotu elementu wokół jego środka zgodnie z ruchem wskazówek zegara w stopniach.
setStart(left, top)LineUstawia położenie punktu początkowego linii.
setStart(point)LineUstawia pozycję punktu początkowego linii.
setStartArrow(style)LineUstawia ArrowStyle strzałki na początku linii.
setStartConnection(connectionSite)LineUstawia połączenie na początku wiersza.
setTitle(title)LineUstawia tytuł tekstu alternatywnego elementu strony.
setTop(top)LineUstawia położenie pionowe elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.
setTransform(transform)LineUstawia przekształcenie elementu strony za pomocą podanego przekształcenia.
setWeight(points)LineUstawia grubość linii w punktach.
setWidth(width)LineUstawia szerokość elementu w punktach, czyli szerokość jego prostokąta ograniczającego, gdy nie jest on obracany.

Szczegółowa dokumentacja

alignOnPage(alignmentPosition)

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

Parametry

NazwaTypOpis
alignmentPositionAlignmentPositionPozycja, w której ma być wyrównany ten element strony.

Powrót

Line – ten element strony, do łańcuchowania.


bringForward()

Przesuwa element o jeden element w górę.

Element strony nie może być w grupie.

Powrót

Line – ten element strony do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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()

Przesuwa element na wierzch strony.

Element strony nie może być w grupie.

Powrót

Line – ten element strony, do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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()

Zduplikuje element strony.

Zduplikowany element strony jest umieszczany na tej samej stronie i w tej samej pozycji co element oryginalny.

Powrót

PageElement – nowy duplikat tego elementu strony.

Autoryzacja

Skrypty, które korzystają 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 połączenia.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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

getDashStyle()

Pobiera wartość DashStyle wiersza.

Powrót

DashStyle – styl kreskowania używany w przypadku tej linii.

Autoryzacja

Skrypty, które korzystają 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 wyświetlać i czytać tekst alternatywny.

Powrót

String – opis tekstu alternatywnego elementu strony.

Autoryzacja

Skrypty, które korzystają 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

getEnd()

Zwraca punkt końcowy linii, mierzony od lewego górnego rogu strony.

Powrót

Point – punkt końcowy linii.

Autoryzacja

Skrypty, które korzystają 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

getEndArrow()

Pobiera ArrowStyle strzałki na końcu wiersza.

Powrót

ArrowStyle – styl strzałki na końcu tego wiersza.

Autoryzacja

Skrypty, które korzystają 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

getEndConnection()

Zwraca połączenie na końcu linii lub null, jeśli nie ma połączenia.

Powrót

ConnectionSite – połączenie na końcu linii.

Autoryzacja

Skrypty, które korzystają 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ść jego prostokąta ograniczającego, gdy nie jest on obracany.

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

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 wbudowaną wysokość elementu w punktach.

Przekształcenie elementu strony jest względne względem jego rzeczywistego rozmiaru. Użyj rozmiaru elementu w połączeniu z jego przekształceniem, aby określić jego ostateczny wygląd.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 wbudowaną szerokość elementu w punktach.

Przekształcenie elementu strony jest względne względem jego rzeczywistego rozmiaru. Aby określić ostateczny wygląd wizualny elementu, użyj jego rozmiaru bezwzględnego w połączeniu z jego przekształceniem.

Powrót

Number – Właściwa szerokość elementu strony w punktach lub null, jeśli element strony nie ma szerokości.

Autoryzacja

Skrypty, które korzystają 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 poziomą pozycję elementu w punktach, mierząc od lewego górnego rogu strony, gdy element nie jest obracany.

Powrót

Number – poziome położenie tego elementu w punktach, licząc od lewego górnego rogu strony.

Autoryzacja

Skrypty, które korzystają 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

getLineCategory()

Pobiera wartość LineCategory wiersza.

Powrót

LineCategory – kategoria linii.

Autoryzacja

Skrypty, które korzystają 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

getLineFill()

Pobiera wartość LineFill wiersza.

Powrót

LineFill – ustawienie wypełnienia tej linii.

Autoryzacja

Skrypty, które korzystają 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

getLineType()

Pobiera wartość LineType wiersza.

Powrót

LineType – typ tej linii.

Autoryzacja

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

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

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

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

Powrót

Link – Link lub null, jeśli nie ma połączenia.

Autoryzacja

Skrypty, które korzystają 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 należą do tej samej przestrzeni nazw.

Powrót

String – niepowtarzalny identyfikator tego obiektu.

Autoryzacja

Skrypty, które korzystają 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 jako typ PageElementType.

Powrót

PageElementType – typ elementu strony.

Autoryzacja

Skrypty, które korzystają 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 żadnej grupy.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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ę element strony.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 wokół jego środka w stopniach, przy czym 0 stopni oznacza brak obrotu.

Powrót

Number – kąt obrotu wyrażony w stopniach w zakresie od 0 (włącznie) do 360 (wyłącznie).

Autoryzacja

Skrypty, które korzystają 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

getStart()

Zwraca punkt początkowy linii, mierzony od lewego górnego rogu strony.

Powrót

Point – punkt początkowy linii.

Autoryzacja

Skrypty, które korzystają 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

getStartArrow()

Pobiera ArrowStyle strzałki na początku wiersza.

Powrót

ArrowStyle – styl strzałki na początku tego wiersza.

Autoryzacja

Skrypty, które korzystają 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

getStartConnection()

Zwraca połączenie na początku wiersza lub null, jeśli nie ma połączenia.

Powrót

ConnectionSite – połączenie na początku wiersza.

Autoryzacja

Skrypty, które korzystają 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świetlać i odczytywać tekst alternatywny.

Powrót

String – tytuł tekstu alternatywnego elementu strony.

Autoryzacja

Skrypty, które korzystają 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 pionowe położenie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.

Powrót

Number – pionowe położenie tego elementu w punktach, licząc od lewego górnego rogu strony.

Autoryzacja

Skrypty, które korzystają 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 transformację elementu strony.

Wizualny wygląd elementu strony jest określany przez jego bezwzględną transformację. Aby obliczyć transformację bezwzględną, złącz uprzednio transformację elementu strony z transformacjami wszystkich jego grup nadrzędnych. Jeśli element strony nie znajduje się w grupie, jego transformacja bezwzględna jest taka sama jak wartość w tym polu.

Powrót

AffineTransform – transformacja elementu strony.

Autoryzacja

Skrypty, które korzystają 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

getWeight()

Zwraca grubość linii w punktach.

Powrót

Number – grubość linii w punktach.

Autoryzacja

Skrypty, które korzystają 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ść jego prostokąta ograniczającego, gdy element nie jest obrócony.

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

Powrót

Number – Właściwa szerokość elementu strony w punktach lub null, jeśli element strony nie ma szerokości.

Autoryzacja

Skrypty, które korzystają 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

isConnector()

Zwraca wartość true, jeśli linia jest łącznikiem, lub wartość false, jeśli nie.

Połączenie to rodzaj linii służący do łączenia punktów połączenia w odpowiednich elementach strony. Każdy koniec złącza może być połączony z maksymalnie 1 miejscem połączenia.

Powrót

Boolean – True, jeśli linia jest łącznikiem, lub false, jeśli nie.

Autoryzacja

Skrypty, które korzystają 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)

Przekształca podany obiekt transformacji w istniejącą transformację elementu strony.

newTransform = argument * existingTransform;

Aby na przykład przesunąć element strony o 36 punktów w lewo:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

Możesz też zastąpić transformację elementu strony wartością setTransform(transform).

Parametry

NazwaTypOpis
transformAffineTransformTransformacja do wstępnego konkatenowania na potrzeby transformacji tego elementu strony.

Powrót

Line – ten element strony, do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 żadnego, sama grupa również zostanie usunięta.

Jeśli w masterze lub szablonie usuniesz element zastępczy PageElement, zostaną też usunięte wszystkie puste elementy zastępcze, które go dziedziczyły.

Autoryzacja

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

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

Usuwa Link.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

reroute()

Przekierowuje początek i koniec linii do dwóch najbliżej położonych miejsc połączenia w połączonych elementach strony. Początek i koniec linii muszą być połączone z różnymi elementami strony.

Powrót

Line – linia.

Autoryzacja

Skrypty, które korzystają 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 zgodnie z określonym współczynnikiem. Wysokość elementu to wysokość jego ogranicznika, gdy element nie jest obracany.

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

Parametry

NazwaTypOpis
ratioNumberWspółczynnik, o który należy pomnożyć wysokość tego elementu strony.

Powrót

Line – ten element strony do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 zgodnie z określonym współczynnikiem. Szerokość elementu to szerokość jego ogranicznika, gdy element nie jest obracany.

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

Parametry

NazwaTypOpis
ratioNumberWspółczynnik, o który należy pomnożyć szerokość tego elementu strony.

Powrót

Line – ten element strony do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 PageElement w aktywnej prezentacji i usuwa wszystkie poprzednie zaznaczenia. To samo co wywołanie funkcji select(replace) z argumentem true.

Skrypt może uzyskać dostęp tylko do elementów wybranych przez użytkownika, który go uruchamia, i tylko wtedy, gdy skrypt jest powiązany z prezentacją.

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

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

Autoryzacja

Skrypty, które korzystają 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 PageElement w aktywnej prezentacji.

Skrypt może uzyskać dostęp tylko do elementów wybranych przez użytkownika, który go uruchamia, i tylko wtedy, gdy skrypt jest powiązany z prezentacją.

Przekaż zmienną true do tej metody, aby wybrać tylko PageElement i usunąć poprzednie zaznaczenie. W ten sposób ustawiasz też element nadrzędny Page elementu PageElement jako current page selection.

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

Podczas wybierania elementu strony za pomocą parametru false należy spełnić te warunki:

  1. Obiekt nadrzędny Page obiektu PageElement musi być obiektem current page selection.
  2. Nie powinno być wybranych kilku obiektów Page.

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

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

Parametry

NazwaTypOpis
replaceBooleanJeśli zaznaczone jest true, wybór zastępuje wszystkie poprzednie; w przeciwnym razie dodawany jest do poprzedniego.

Autoryzacja

Skrypty, które korzystają 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 być w grupie.

Powrót

Line – ten element strony do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 na końcu strony.

Element strony nie może być w grupie.

Powrót

Line – ten element strony do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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

setDashStyle(style)

Ustawia DashStyle linii.

Parametry

NazwaTypOpis
styleDashStyleStyl kreskowania do ustawienia dla tej linii.

Powrót

Line – ta linia do łańcucha.

Autoryzacja

Skrypty, które korzystają 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".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parametry

NazwaTypOpis
descriptionStringCiąg tekstowy, w którym ma być ustawiony tekst alternatywny.

Powrót

Line – ten element strony.

Autoryzacja

Skrypty, które korzystają 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

setEnd(left, top)

Ustawia pozycję punktu końcowego linii.

Po zmianie pozycji ścieżka linii może zostać dostosowana.

Parametry

NazwaTypOpis
leftNumberPozycja pozioma punktu końcowego linii, mierzona w punktach od lewego górnego rogu strony.
topNumberPozycja pionowa punktu końcowego linii, mierzona w punktach od lewego górnego rogu strony.

Powrót

Line – ta linia do łańcucha.

Autoryzacja

Skrypty, które korzystają 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

setEnd(point)

Ustawia pozycję punktu końcowego linii.

Po zmianie pozycji ścieżka linii może zostać dostosowana.

Parametry

NazwaTypOpis
pointPointPunkt końcowy linii, którego położenie jest mierzone od lewego górnego rogu strony.

Powrót

Line – ta linia do łańcucha.

Autoryzacja

Skrypty, które korzystają 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

setEndArrow(style)

Ustawia ArrowStyle strzałki na końcu linii.

Parametry

NazwaTypOpis
styleArrowStyleStyl do ustawienia.

Powrót

Line – ta linijka służy do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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

setEndConnection(connectionSite)

Ustawia połączenie na końcu linii. Przenosi koniec linii do określonego punktu połączenia, zachowując przy tym drugi koniec.

Parametry

NazwaTypOpis
connectionSiteConnectionSiteMiejsce połączenia, do którego jest aktualizowane połączenie końcowe, lub null, jeśli usuwasz to połączenie.

Powrót

Line – linia.

Autoryzacja

Skrypty, które korzystają 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ść jego prostokąta ograniczającego, gdy nie jest on obracany.

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

Parametry

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

Powrót

Line – ten element strony do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 położenie elementu w osi poziomej w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.

Parametry

NazwaTypOpis
leftNumberNowa pozycja pozioma do ustawienia w punktach.

Powrót

Line – ten element strony do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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

setLineCategory(lineCategory)

Ustawia LineCategory linii.

Kategorię możesz ustawić tylko w usłudze connectors. Po zmianie kategorii oprogramowanie sprzęgające może zostać przekierowane.

Parametry

NazwaTypOpis
lineCategoryLineCategoryKategoria linii do ustawienia.

Powrót

Line – linia.

Autoryzacja

Skrypty, które korzystają 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)

Przypisuje wartość Link do podanego parametru Slide, używając indeksu liczonego od 0.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

Parametry

NazwaTypOpis
slideIndexIntegerIndeks slajdów liczony od zera.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

Skrypty, które korzystają 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 Link na podanym Slide, a link jest ustawiany za pomocą podanego identyfikatora slajdu.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

Parametry

NazwaTypOpis
slideSlideSlide, które mają być połączone.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

Skrypty, które korzystają 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 podanej wartości Slide, używając względnego położenia slajdu.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Parametry

NazwaTypOpis
slidePositionSlidePositionWzględne SlidePosition.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

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

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

setLinkUrl(url)

Ustawia Link na podany niepusty ciąg znaków adresu URL.

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

Parametry

NazwaTypOpis
urlStringAdres URL.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

Skrypty, które korzystają 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 zgodnie z ruchem wskazówek zegara w stopniach.

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

Parametry

NazwaTypOpis
angleNumberNowy kąt obrotu zgodnie z ruchem wskazówek zegara do ustawienia w stopniach.

Powrót

Line – ten element strony do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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

setStart(left, top)

Ustawia pozycję punktu początkowego linii.

Po zmianie pozycji ścieżka linii może zostać dostosowana.

Parametry

NazwaTypOpis
leftNumberPozycja pozioma punktu początkowego linii, mierzona w punktach od lewego górnego rogu strony.
topNumberPozycja pionowa punktu początkowego linii, mierzona w punktach od lewego górnego rogu strony.

Powrót

Line – ta linia do łańcucha.

Autoryzacja

Skrypty, które korzystają 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

setStart(point)

Ustawia położenie punktu początkowego linii.

Po zmianie pozycji ścieżka linii może zostać dostosowana.

Parametry

NazwaTypOpis
pointPointPunkt początkowy linii, którego położenie jest mierzone od lewego górnego rogu strony.

Powrót

Line – ta linia do łańcucha.

Autoryzacja

Skrypty, które korzystają 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

setStartArrow(style)

Ustawia ArrowStyle strzałki na początku linii.

Parametry

NazwaTypOpis
styleArrowStyleNowy styl strzałki do ustawienia.

Powrót

Line – ta linijka służy do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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

setStartConnection(connectionSite)

Ustawia połączenie na początku wiersza. Przenosi początek linii do wskazanego miejsca połączenia, zachowując przy tym drugi koniec.

Parametry

NazwaTypOpis
connectionSiteConnectionSiteMiejsce połączenia, do którego jest aktualizowane połączenie startowe, lub null, jeśli usuwasz połączenie startowe.

Powrót

Line – linia.

Autoryzacja

Skrypty, które korzystają 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".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parametry

NazwaTypOpis
titleStringCiąg tekstowy, w którym ma być ustawiony tytuł tekstu alternatywnego.

Powrót

Line – ten element strony.

Autoryzacja

Skrypty, które korzystają 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 położenie pionowe elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.

Parametry

NazwaTypOpis
topNumberNowa pozycja pionowa do ustawienia w punktach.

Powrót

Line – ten element strony do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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.

Zmiana transformacji grupy zmienia bezwzględną transformację elementów strony w tej grupie, co może zmienić ich wygląd.

Zmiana transformacji elementu strony, który jest w grupie, zmienia tylko transformację tego elementu. Nie wpływa na transformacje grupy ani innych elementów strony w grupie.

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

Parametry

NazwaTypOpis
transformAffineTransformTransformacja ustawiona dla tego elementu strony.

Powrót

Line – ten element do łańcucha.

Autoryzacja

Skrypty, które korzystają 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

setWeight(points)

Ustawia grubość linii w punktach.

Parametry

NazwaTypOpis
pointsNumberNowa grubość linii w punktach.

Powrót

Line – ta linia do łańcucha.

Autoryzacja

Skrypty, które korzystają 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ść jego prostokąta ograniczającego, gdy nie jest on obracany.

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

Parametry

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

Powrót

Line – ten element strony do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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