Ta strona została przetłumaczona przez Cloud Translation API.

Class Shape

PageElement oznacza ogólny kształt, który nie ma bardziej szczegółowej klasyfikacji. Obejmuje pola tekstowe, prostokąty i inne wstępnie zdefiniowane kształty.

Metody

Metoda	Zwracany typ	Krótki opis
`alignOnPage(alignmentPosition)`	`Shape`	Wyrównuje element do określonej pozycji wyrównania na stronie.
`bringForward()`	`Shape`	Przesuwa element o jeden element w górę.
`bringToFront()`	`Shape`	Przesuwa element na wierzch strony.
`duplicate()`	`PageElement`	Zduplikuje element strony.
`getAutofit()`	`Autofit`	Zwraca `Autofit` tekstu w tym kształcie.
`getBorder()`	`Border`	Zwraca `Border` kształtu.
`getConnectionSites()`	`ConnectionSite[]`	Zwraca listę `ConnectionSite` w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych miejsc połączenia.
`getContentAlignment()`	`ContentAlignment`	Zwraca `ContentAlignment` tekstu w kształcie.
`getDescription()`	`String`	Zwraca opis tekstu alternatywnego elementu strony.
`getFill()`	`Fill`	Zwraca `Fill` kształtu.
`getHeight()`	`Number`	Pobiera wysokość elementu w punktach, czyli wysokość jego prostokąta ograniczającego, gdy nie jest on obracany.
`getInherentHeight()`	`Number`	Zwraca wbudowaną wysokość elementu w punktach.
`getInherentWidth()`	`Number`	Zwraca wbudowaną szerokość elementu w punktach.
`getLeft()`	`Number`	Zwraca poziomą pozycję elementu w punktach, mierząc od lewego górnego rogu strony, gdy element nie jest obracany.
`getLink()`	`Link`	Zwraca wartość `Link` lub `null`, jeśli nie ma linku.
`getObjectId()`	`String`	Zwraca unikalny identyfikator tego obiektu.
`getPageElementType()`	`PageElementType`	Zwraca typ elementu strony jako typ enumeracji `PageElementType`.
`getParentGroup()`	`Group`	Zwraca grupę, do której należy ten element strony, lub `null`, jeśli element nie należy do żadnej grupy.
`getParentPage()`	`Page`	Zwraca stronę, na której znajduje się element strony.
`getParentPlaceholder()`	`PageElement`	Zwraca element strony nadrzędnej elementu zastępczego.
`getPlaceholderIndex()`	`Integer`	Zwraca indeks zastępnika kształtu.
`getPlaceholderType()`	`PlaceholderType`	Zwraca typ zastępczego kształtu lub wartość `PlaceholderType.NONE`, jeśli kształt nie jest zastępczy.
`getRotation()`	`Number`	Zwraca kąt obrotu elementu wokół jego środka w stopniach, przy czym 0 stopni oznacza brak obrotu.
`getShapeType()`	`ShapeType`	Zwraca typ kształtu.
`getText()`	`TextRange`	Zwraca zawartość tekstową kształtu.
`getTitle()`	`String`	Zwraca tytuł tekstu alternatywnego elementu strony.
`getTop()`	`Number`	Pobiera pionowe położenie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.
`getTransform()`	`AffineTransform`	Zwraca transformację elementu strony.
`getWidth()`	`Number`	Zwraca szerokość elementu w punktach, czyli szerokość jego prostokąta ograniczającego, gdy element nie jest obrócony.
`preconcatenateTransform(transform)`	`Shape`	Przekształca podany obiekt transformacji w istniejącą transformację elementu strony.
`remove()`	`void`	Usuwa element strony.
`removeLink()`	`void`	Usuwa `Link`.
`replaceWithImage(blobSource)`	`Image`	Zastępuje ten kształt obrazem dostarczonym przez `BlobSource`.
`replaceWithImage(blobSource, crop)`	`Image`	Zastępuje ten kształt obrazem dostarczonym przez `BlobSource`.
`replaceWithImage(imageUrl)`	`Image`	Zastępuje ten kształt obrazem.
`replaceWithImage(imageUrl, crop)`	`Image`	Zastępuje ten kształt obrazem.
`replaceWithSheetsChart(sourceChart)`	`SheetsChart`	Zastępuje ten kształt wykresem w Arkuszach Google.
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	Zastępuje ten kształt obrazem wykresu z Arkuszy Google.
`scaleHeight(ratio)`	`Shape`	Skaluje wysokość elementu zgodnie z określonym współczynnikiem.
`scaleWidth(ratio)`	`Shape`	Skaluje szerokość elementu według określonego współczynnika.
`select()`	`void`	Wybiera tylko `PageElement` w aktywnej prezentacji i usuwa wszystkie poprzednie zaznaczenia.
`select(replace)`	`void`	Wybiera `PageElement` w aktywnej prezentacji.
`sendBackward()`	`Shape`	Przesuwa element o jeden element w tył.
`sendToBack()`	`Shape`	Przesuwa element na końcu strony.
`setContentAlignment(contentAlignment)`	`Shape`	Ustawia `ContentAlignment` tekstu w kształcie.
`setDescription(description)`	`Shape`	Ustawia tekst alternatywny elementu strony.
`setHeight(height)`	`Shape`	Ustawia wysokość elementu w punktach, czyli wysokość jego prostokąta ograniczającego, gdy nie jest on obracany.
`setLeft(left)`	`Shape`	Ustawia położenie elementu w osi poziomej w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.
`setLinkSlide(slideIndex)`	`Link`	Przypisuje wartość `Link` do podanego parametru `Slide`, używając indeksu liczonego od 0.
`setLinkSlide(slide)`	`Link`	Ustawia `Link` na podanym `Slide`, a link jest ustawiany za pomocą podanego identyfikatora slajdu.
`setLinkSlide(slidePosition)`	`Link`	Ustawia `Link` na podanej wartości `Slide`, używając względnego położenia slajdu.
`setLinkUrl(url)`	`Link`	Ustawia `Link` na podany niepusty ciąg znaków adresu URL.
`setRotation(angle)`	`Shape`	Ustawia kąt obrotu elementu wokół jego środka zgodnie z ruchem wskazówek zegara w stopniach.
`setTitle(title)`	`Shape`	Ustawia tytuł tekstu alternatywnego elementu strony.
`setTop(top)`	`Shape`	Ustawia położenie pionowe elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obracany.
`setTransform(transform)`	`Shape`	Ustawia przekształcenie elementu strony za pomocą podanego przekształcenia.
`setWidth(width)`	`Shape`	Ustawia 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

Nazwa	Typ	Opis
`alignmentPosition`	`AlignmentPosition`	Pozycja, w której ma być wyrównany ten element strony.

Powrót

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

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

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

`getAutofit()`

Zwraca Autofit tekstu w tym kształcie. null, jeśli kształt nie pozwala na umieszczenie tekstu.

Powrót

Autofit – automatyczne dopasowanie tekstu w tym kształcie.

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

`getBorder()`

Zwraca Border kształtu.

Powrót

Border – ustawienie obramowania tego kształtu.

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

`getContentAlignment()`

Zwraca ContentAlignment tekstu w kształcie.

Powrót

ContentAlignment – wyrównanie tekstu w tym kształcie.

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

`getFill()`

Zwraca Fill kształtu.

Powrót

Fill – ustawienie wypełnienia tego kształtu.

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

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

`getLink()`

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

`getParentPlaceholder()`

Zwraca element strony nadrzędnej elementu zastępczego. Zwraca null, jeśli kształt nie jest zastępnikiem lub nie ma elementu nadrzędnego.

Powrót

PageElement – nadrzędny element strony tego placeholdera kształtu lub null, jeśli kształt nie jest placeholderem lub nie ma nadrzędnego.

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

`getPlaceholderIndex()`

Zwraca indeks zastępnika kształtu. Jeśli na tej samej stronie znajduje się co najmniej 2 typy placeholderów, każdy z nich ma swoją własną wartość indeksu. Zwraca null, jeśli kształt nie jest obiektem zastępczym.

Powrót

Integer – indeks symbolu zastępczego tego kształtu lub null, jeśli kształt nie jest symbolem zastępczym.

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

`getPlaceholderType()`

Zwraca typ zastępczego kształtu lub wartość PlaceholderType.NONE, jeśli kształt nie jest zastępczy.

Powrót

PlaceholderType – typ obiektu zastępczego tego kształtu.

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

`getShapeType()`

Zwraca typ kształtu.

Powrót

ShapeType – typ kształtu.

`getText()`

Zwraca zawartość tekstową kształtu.

Tekst w kształcie zawsze kończy się znakiem nowego wiersza.

Powrót

TextRange – zawartość tekstowa tego kształtu.

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

Zwraca 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

`getWidth()`

Zwraca szerokość elementu w punktach, czyli szerokość jego prostokąta ograniczającego, gdy element nie jest obrócony.

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

`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

Nazwa	Typ	Opis
`transform`	`AffineTransform`	Transformacja do wstępnego konkatenowania na potrzeby transformacji tego elementu strony.

Powrót

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

`removeLink()`

Usuwa Link.

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

`replaceWithImage(blobSource)`

Zastępuje ten kształt obrazem dostarczonym przez BlobSource.

Obraz jest pobierany z podanego adresu BlobSource raz w momencie wstawienia, a jego kopia jest przechowywana na potrzeby wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.

Aby zachować współczynnik proporcji obrazu, obraz jest skalowany i wyśrodkowywany względem rozmiaru dotychczasowego kształtu.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
shape.replaceWithImage(driveImage);

Parametry

Nazwa	Typ	Opis
`blobSource`	`BlobSource`	Dane obrazu.

Powrót

Image – Image, który zastąpił kształt.

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

`replaceWithImage(blobSource, crop)`

Zastępuje ten kształt obrazem dostarczonym przez BlobSource.

Wstawianie obrazu powoduje jego pobranie z BlobSource, a kopia jest przechowywana na potrzeby wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą mieć więcej niż 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

Parametry

Nazwa	Typ	Opis
`blobSource`	`BlobSource`	Dane obrazu.
`crop`	`Boolean`	Jeśli `true`, obraz jest przycinany tak, aby pasował do rozmiaru bieżącego kształtu. W przeciwnym razie obraz zostanie przeskalowany i wyśrodkowany.

Powrót

Image – Image, który zastąpił kształt.

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

`replaceWithImage(imageUrl)`

Zastępuje ten kształt obrazem.

Wstawianie obrazu powoduje jego pobieranie z adresu URL, a kopia jest przechowywana na potrzeby wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.

Podany adres URL musi być dostępny publicznie i nie może mieć rozmiaru większego niż 2 KB. Sam adres URL jest zapisywany wraz z obrazem i wyświetlany za pomocą Image.getSourceUrl().

Aby zachować współczynnik proporcji obrazu, obraz jest skalowany i wyśrodkowywany względem rozmiaru dotychczasowego kształtu.

Parametry

Nazwa	Typ	Opis
`imageUrl`	`String`	Adres URL obrazu, z którego chcesz pobrać obraz.

Powrót

Image – Image, który zastąpił kształt.

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

`replaceWithImage(imageUrl, crop)`

Zastępuje ten kształt obrazem.

Podany adres URL nie może być dłuższy niż 2 kB. Sam adres URL jest zapisywany wraz z obrazem i wyświetlany za pomocą Image.getSourceUrl().

Parametry

Nazwa	Typ	Opis
`imageUrl`	`String`	Adres URL obrazu, z którego chcesz pobrać obraz.
`crop`	`Boolean`	Jeśli `true`, obraz jest przycinany tak, aby pasował do rozmiaru bieżącego kształtu. W przeciwnym razie obraz zostanie przeskalowany i wyśrodkowany.

Powrót

Image – Image, który zastąpił kształt.

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

`replaceWithSheetsChart(sourceChart)`

Zastępuje ten kształt wykresem w Arkuszach Google.

Wykres jest połączony ze źródłowym wykresem w Arkuszach Google, co umożliwia jego aktualizowanie. Inni współpracownicy mogą zobaczyć link do źródłowego arkusza kalkulacyjnego.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

Parametry

Nazwa	Typ	Opis
`sourceChart`	`EmbeddedChart`	wykres w arkuszu kalkulacyjnym, który zastępuje kształt;

Powrót

SheetsChart – wykres, który zastąpił kształt.

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

`replaceWithSheetsChartAsImage(sourceChart)`

Zastępuje ten kształt obrazem wykresu z Arkuszy Google.

Aby zachować format obrazu wykresu w Arkuszach Google, obraz wykresu jest skalowany i wyśrodkowywany względem rozmiaru dotychczasowego kształtu.

Obraz wykresu nie jest połączony z wykresem źródłowym z Arkuszy Google.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

Parametry

Nazwa	Typ	Opis
`sourceChart`	`EmbeddedChart`	wykres w arkuszu kalkulacyjnym, który zastępuje kształt;

Powrót

Image – obraz wykresu, który zastąpił kształt.

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.

Parametry

Nazwa	Typ	Opis
`ratio`	`Number`	Współczynnik, o który należy pomnożyć wysokość tego elementu strony.

Powrót

Shape – 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 według określonego współczynnika. Szerokość elementu to szerokość jego ogranicznika, gdy element nie jest obracany.

Parametry

Nazwa	Typ	Opis
`ratio`	`Number`	Współczynnik, o który należy pomnożyć szerokość tego elementu strony.

Powrót

Shape – 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 element 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:

Obiekt nadrzędny Page obiektu PageElement musi być obiektem current page selection.
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

Nazwa	Typ	Opis
`replace`	`Boolean`	Jeś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 o jeden element w tył.

Element strony nie może być w grupie.

Powrót

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

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

`setContentAlignment(contentAlignment)`

Ustawia ContentAlignment tekstu w kształcie.

Ta metoda automatycznie dezaktywuje właściwości automatycznego dopasowania tekstu w zaktualizowanych kształtach.

Parametry

Nazwa	Typ	Opis
`contentAlignment`	`ContentAlignment`	Wybierz sposób wyrównania.

Powrót

Shape – ten kształt 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

`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

Nazwa	Typ	Opis
`description`	`String`	Ciąg znaków, w którym ma być ustawiony tekst alternatywny.

Powrót

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

`setHeight(height)`

Ustawia wysokość elementu w punktach. Jest to wysokość jego prostokąta ograniczającego, gdy nie jest on obracany.

Parametry

Nazwa	Typ	Opis
`height`	`Number`	Nowa wysokość tego elementu strony do ustawienia w punktach.

Powrót

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

Nazwa	Typ	Opis
`left`	`Number`	Nowa pozycja pozioma do ustawienia w punktach.

Powrót

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

`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

Nazwa	Typ	Opis
`slideIndex`	`Integer`	Indeks 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

Nazwa	Typ	Opis
`slide`	`Slide`	`Slide`, 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

Nazwa	Typ	Opis
`slidePosition`	`SlidePosition`	Wzglę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

Nazwa	Typ	Opis
`url`	`String`	Adres 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.

Parametry

Nazwa	Typ	Opis
`angle`	`Number`	Nowy kąt obrotu zgodnie z ruchem wskazówek zegara do ustawienia w stopniach.

Powrót

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

`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

Nazwa	Typ	Opis
`title`	`String`	Ciąg tekstowy, w którym ma być ustawiony tytuł tekstu alternatywnego.

Powrót

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

Nazwa	Typ	Opis
`top`	`Number`	Nowa pozycja pionowa do ustawienia w punktach.

Powrót

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

Nazwa	Typ	Opis
`transform`	`AffineTransform`	Transformacja ustawiona dla tego elementu strony.

Powrót

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

`setWidth(width)`

Ustawia szerokość elementu w punktach, czyli szerokość jego prostokąta ograniczającego, gdy nie jest on obracany.

Parametry

Nazwa	Typ	Opis
`width`	`Number`	Nowa szerokość tego elementu strony do ustawienia w punktach.

Powrót

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