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

Class Shape

PageElement – ogólny kształt, który nie ma bardziej szczegółowej klasyfikacji. Obejmuje pola tekstowe, prostokąty i inne predefiniowane 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 strony o jeden element do przodu.
`bringToFront()`	`Shape`	Przesuwa element strony na wierzch.
`duplicate()`	`PageElement`	Duplikuje element strony.
`getAutofit()`	`Autofit\|null`	Zwraca `Autofit` tekstu w tym kształcie.
`getBorder()`	`Border`	Zwraca `Border` kształtu.
`getConnectionSites()`	`ConnectionSite[]`	Zwraca listę elementów `ConnectionSite` na elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn połączeń.
`getContentAlignment()`	`ContentAlignment`	Zwraca `ContentAlignment` tekstu w kształcie.
`getDescription()`	`String`	Zwraca opis tekstu alternatywnego elementu strony.
`getFill()`	`Fill`	Zwraca `Fill` kształtu.
`getHeight()`	`Number\|null`	Zwraca wysokość elementu w punktach, czyli wysokość pola ograniczającego elementu, gdy element nie jest obrócony.
`getInherentHeight()`	`Number\|null`	Zwraca domyślną wysokość elementu w punktach.
`getInherentWidth()`	`Number\|null`	Zwraca wrodzoną szerokość elementu w punktach.
`getLeft()`	`Number`	Zwraca poziomą pozycję elementu w punktach, mierzoną od lewego górnego rogu strony, gdy element nie jest obrócony.
`getLink()`	`Link\|null`	Zwraca wartość `Link` lub `null`, jeśli nie ma linku.
`getObjectId()`	`String`	Zwraca unikalny identyfikator tego obiektu.
`getPageElementType()`	`PageElementType`	Zwraca typ elementu strony reprezentowany jako wyliczenie `PageElementType`.
`getParentGroup()`	`Group\|null`	Zwraca grupę, do której należy ten element strony, lub `null`, jeśli element nie należy do grupy.
`getParentPage()`	`Page`	Zwraca stronę, na której znajduje się ten element strony.
`getParentPlaceholder()`	`PageElement\|null`	Zwraca element strony nadrzędnej symbolu zastępczego.
`getPlaceholderIndex()`	`Integer\|null`	Zwraca indeks symbolu zastępczego kształtu.
`getPlaceholderType()`	`PlaceholderType`	Zwraca typ obiektu zastępczego kształtu lub `PlaceholderType.NONE`, jeśli kształt nie jest obiektem zastępczym.
`getRotation()`	`Number`	Zwraca kąt obrotu elementu wokół jego środka w stopniach, gdzie 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 obrócony.
`getTransform()`	`AffineTransform`	Zwraca przekształcenie elementu strony.
`getWidth()`	`Number\|null`	Zwraca szerokość elementu w punktach, czyli szerokość ramki ograniczającej elementu, gdy element nie jest obrócony.
`preconcatenateTransform(transform)`	`Shape`	Łączy podaną transformację z 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 z Arkuszy Google.
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	Zastępuje ten kształt obrazem wykresu z Arkuszy Google.
`scaleHeight(ratio)`	`Shape`	Skaluje wysokość elementu według określonego współczynnika.
`scaleWidth(ratio)`	`Shape`	Skaluje szerokość elementu według określonego współczynnika.
`select()`	`void`	Zaznacza tylko `PageElement` w aktywnej prezentacji i usuwa poprzedni wybór.
`select(replace)`	`void`	Wybiera `PageElement` w aktywnej prezentacji.
`sendBackward()`	`Shape`	Przesuwa element strony o jeden element do tyłu.
`sendToBack()`	`Shape`	Przesuwa element strony na spód 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ść ramki ograniczającej element, gdy nie jest on obrócony.
`setLeft(left)`	`Shape`	Określa położenie elementu w poziomie w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.
`setLinkSlide(slideIndex)`	`Link`	Ustawia `Link` na podany `Slide`, używając indeksu slajdu liczonego od zera.
`setLinkSlide(slide)`	`Link`	Ustawia `Link` na podany `Slide`, a link jest ustawiany przez podany identyfikator slajdu.
`setLinkSlide(slidePosition)`	`Link`	Ustawia `Link` na podany `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`	Określa pionowe położenie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.
`setTransform(transform)`	`Shape`	Ustawia przekształcenie elementu strony za pomocą podanego przekształcenia.
`setWidth(width)`	`Shape`	Ustawia szerokość elementu w punktach, czyli szerokość pola ograniczającego elementu, gdy element nie jest obrócony.

Szczegółowa dokumentacja

`alignOnPage(alignmentPosition)`

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

Parametry

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

Powrót

Shape – ten element strony służy do łączenia.

`bringForward()`

Przesuwa element strony o jeden element do przodu.

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

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

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

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

`bringToFront()`

Przesuwa element strony na wierzch.

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

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

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

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

`duplicate()`

Duplikuje element strony.

Zduplikowany element strony jest umieszczany na tej samej stronie w tym samym miejscu co oryginał.

Powrót

PageElement – nowy duplikat tego elementu strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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. Jest to null, jeśli kształt nie zezwala na tekst.

Powrót

Autofit|null – automatyczne dopasowanie tekstu do kształtu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getConnectionSites()`

Zwraca listę elementów ConnectionSite na elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn połączeń.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 odczytywać tekst alternatywny.

Powrót

String – tekst alternatywny elementu strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getHeight()`

Zwraca wysokość elementu w punktach, czyli wysokość pola ograniczającego elementu, 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 położenia.

Powrót

Number|null – domyślna wysokość elementu strony w punktach lub null, jeśli element strony nie ma wysokości.

Autoryzacja

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

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

`getInherentHeight()`

Zwraca domyślną wysokość elementu w punktach.

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

Powrót

Number|null – domyślna wysokość elementu strony w punktach lub null, jeśli element strony nie ma wysokości.

Autoryzacja

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

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

`getInherentWidth()`

Zwraca wrodzoną szerokość elementu w punktach.

Powrót

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

Autoryzacja

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

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

`getLeft()`

Zwraca poziomą pozycję elementu w punktach, mierzoną od lewego górnego rogu strony, gdy element nie jest obrócony.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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|null – Link lub null, jeśli nie ma linku.

Autoryzacja

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

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

`getObjectId()`

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

Powrót

String – unikalny identyfikator tego obiektu.

Autoryzacja

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

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

`getPageElementType()`

Zwraca typ elementu strony reprezentowany jako wyliczenie PageElementType.

Powrót

PageElementType – typ elementu strony.

Autoryzacja

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

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

`getParentGroup()`

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

Powrót

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

Autoryzacja

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

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

`getParentPage()`

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

Powrót

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

Autoryzacja

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

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

`getParentPlaceholder()`

Zwraca element strony nadrzędnej symbolu zastępczego. Zwraca wartość null, jeśli kształt nie jest symbolem zastępczym lub nie ma elementu nadrzędnego.

Powrót

PageElement|null – element strony nadrzędnej tego symbolu zastępczego kształtu lub null, jeśli ten kształt nie jest symbolem zastępczym lub nie ma elementu nadrzędnego.

Autoryzacja

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

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

`getPlaceholderIndex()`

Zwraca indeks symbolu zastępczego kształtu. Jeśli na tej samej stronie występuje co najmniej 2 instancje tego samego typu elementu zastępczego, każda z nich ma własną, niepowtarzalną wartość indeksu. Zwraca wartość null, jeśli kształt nie jest obiektem zastępczym.

Powrót

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

Autoryzacja

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

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

`getPlaceholderType()`

Zwraca typ obiektu zastępczego kształtu lub PlaceholderType.NONE, jeśli kształt nie jest obiektem zastępczym.

Powrót

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

Autoryzacja

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

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

`getRotation()`

Zwraca kąt obrotu elementu wokół jego środka w stopniach, gdzie 0 stopni oznacza brak obrotu.

Powrót

Number – kąt obrotu w stopniach z zakresu od 0 (włącznie) do 360 (wyłącznie).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 tego 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`getTitle()`

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

Powrót

String – tytuł tekstu alternatywnego elementu strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 obrócony.

Powrót

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

Autoryzacja

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

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

`getTransform()`

Zwraca przekształcenie elementu strony.

Wygląd elementu strony jest określany przez jego przekształcenie bezwzględne. Aby obliczyć przekształcenie bezwzględne, połącz przekształcenie elementu strony z przekształceniami wszystkich jego grup nadrzędnych. Jeśli element strony nie należy do grupy, jego bezwzględne przekształcenie jest takie samo jak wartość w tym polu.

Powrót

AffineTransform – przekształcenie elementu strony.

Autoryzacja

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

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

`getWidth()`

Zwraca szerokość elementu w punktach, czyli szerokość ramki ograniczającej elementu, gdy element nie jest obrócony.

Powrót

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

Autoryzacja

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

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

`preconcatenateTransform(transform)`

Łączy podaną transformację z istniejącą transformacją elementu strony.

newTransform = argument * existingTransform;

Jeśli na przykład chcesz przesunąć elementy 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ć przekształcenie elementu strony wartością setTransform(transform).

Parametry

Nazwa	Typ	Opis
`transform`	`AffineTransform`	Przekształcenie, które ma zostać wstępnie połączone z przekształceniem tego elementu strony.

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

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

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

`remove()`

Usuwa element strony.

Jeśli po operacji usuwania grupa Group zawiera tylko 1 element strony lub nie zawiera ich wcale, sama grupa również zostanie usunięta.

Jeśli symbol zastępczy PageElement zostanie usunięty z wzorca lub układu, wszystkie puste symbole zastępcze dziedziczone również zostaną usunięte.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 w momencie wstawienia, a jego kopia jest przechowywana do 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ć format obrazu, jest on skalowany i wyśrodkowywany względem rozmiaru istniejącego 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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.

Wstawienie obrazu powoduje pobranie go z BlobSource i zapisanie kopii do 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.

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`, przycina obraz, aby dopasować go do rozmiaru istniejącego kształtu. W przeciwnym razie obraz jest skalowany i wyśrodkowywany.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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.

Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL i zapisanie kopii do 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 przekraczać 2 KB. Sam adres URL jest zapisywany z obrazem i udostępniany za pomocą Image.getSourceUrl().

Aby zachować format obrazu, jest on skalowany i wyśrodkowywany względem rozmiaru istniejącego kształtu.

Parametry

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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ć większy niż 2 kB. Adres URL jest zapisywany razem z obrazem i udostępniany za pomocą Image.getSourceUrl().

Parametry

Nazwa	Typ	Opis
`imageUrl`	`String`	Adres URL obrazu, z którego można pobrać obraz.
`crop`	`Boolean`	Jeśli `true`, przycina obraz, aby dopasować go do rozmiaru istniejącego kształtu. W przeciwnym razie obraz jest skalowany i wyśrodkowywany.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 z Arkuszy Google.

Wykres jest połączony ze źródłowym wykresem z Arkuszy Google, co umożliwia jego aktualizację. 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 wykresu Arkuszy Google, obraz wykresu jest skalowany i wyśrodkowywany względem rozmiaru istniejącego kształtu.

Obraz wykresu nie jest połączony z wykresem źródłowym w Arkuszach 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`scaleHeight(ratio)`

Skaluje wysokość elementu według określonego współczynnika. Wysokość elementu to wysokość jego pola ograniczającego, gdy element nie jest obrócony.

Parametry

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

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 pola ograniczenia, gdy element nie jest obrócony.

Parametry

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

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

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

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

`select()`

Zaznacza tylko PageElement w aktywnej prezentacji i usuwa poprzedni wybór. Odpowiada to wywołaniu funkcji select(replace) z argumentem true.

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

Spowoduje to ustawienie nadrzędnego Page elementu 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

`select(replace)`

Wybiera PageElement w aktywnej prezentacji.

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

Przekaż do tej metody wartość true, aby wybrać tylko PageElement i usunąć poprzedni wybór. Ustawia to też element nadrzędny Page elementu PageElement jako current page selection.

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

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

Elementem nadrzędnym Page obiektu PageElement musi być current page selection.
Nie powinno być wybranych wielu obiektów Page.

Aby się upewnić, że tak jest, najpierw wybierz element nadrzędny Page za pomocą elementu Page.selectAsCurrentPage(), a potem wybierz 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 `true`, wybór zastępuje poprzedni wybór; w przeciwnym razie wybór jest dodawany do poprzedniego wyboru.

Autoryzacja

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

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

`sendBackward()`

Przesuwa element strony o jeden element do tyłu.

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

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

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

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

`sendToBack()`

Przesuwa element strony na spód strony.

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

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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`	Wyrównanie do ustawienia.

Powrót

Shape – ten kształt służy do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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, który ma być ustawiony jako opis tekstu alternatywnego.

Powrót

Shape – element tej strony.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 nie jest on obrócony.

Parametry

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

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

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

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

`setLeft(left)`

Określa położenie elementu w poziomie w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.

Parametry

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

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

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

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

`setLinkSlide(slideIndex)`

Ustawia Link na podany Slide, używając indeksu slajdu liczonego od zera.

// 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 slajdu liczony od zera.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

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

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

`setLinkSlide(slide)`

Ustawia Link na podany Slide, a link jest ustawiany przez podany identyfikator 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` do połączenia.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

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

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

`setLinkSlide(slidePosition)`

Ustawia Link na podany 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ędna `SlidePosition`.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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`	Ciąg znaków URL.

Powrót

Link – ustawiona wartość Link.

Autoryzacja

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

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

`setRotation(angle)`

Ustawia kąt obrotu elementu wokół jego środka zgodnie z ruchem wskazówek zegara w stopniach.

Parametry

Nazwa	Typ	Opis
`angle`	`Number`	Nowy kąt obrotu w stopniach, który ma zostać ustawiony.

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

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

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

`setTitle(title)`

Ustawia tytuł tekstu alternatywnego elementu strony.

Ta metoda nie jest obsługiwana w przypadku elementów Group.

// Set the first page element's alt text title to "new alt text title".
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 znaków, który ma być tytułem tekstu alternatywnego.

Powrót

Shape – element tej strony.

Autoryzacja

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

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

`setTop(top)`

Określa pionowe położenie elementu w punktach, mierzone od lewego górnego rogu strony, gdy element nie jest obrócony.

Parametry

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

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

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

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

`setTransform(transform)`

Ustawia przekształcenie elementu strony za pomocą podanego przekształcenia.

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

Aktualizacja przekształcenia elementu strony, który znajduje się w grupie, zmienia tylko przekształcenie tego elementu strony. Nie wpływa na przekształcenia grupy ani innych elementów strony w grupie.

Więcej informacji o tym, jak przekształcenia wpływają na wygląd elementów strony, znajdziesz w artykule getTransform().

Parametry

Nazwa	Typ	Opis
`transform`	`AffineTransform`	Przekształcenie ustawione dla tego elementu strony.

Powrót

Shape – ten element do łączenia.

Autoryzacja

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

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

`setWidth(width)`

Ustawia szerokość elementu w punktach, czyli szerokość pola ograniczającego elementu, gdy element nie jest obrócony.

Parametry

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

Powrót

Shape – ten element strony służy do łączenia.

Autoryzacja

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

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

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

Metody

Szczegółowa dokumentacja

alignOnPage(alignmentPosition)

Parametry

Powrót

bringForward()

Powrót

Autoryzacja

bringToFront()

Powrót

Autoryzacja

duplicate()

Powrót

Autoryzacja

getAutofit()

Powrót

Autoryzacja

getBorder()

Powrót

Autoryzacja

getConnectionSites()

Powrót

Autoryzacja

getContentAlignment()

Powrót

Autoryzacja

getDescription()

Powrót

Autoryzacja

getFill()

Powrót

Autoryzacja

getHeight()

Powrót

Autoryzacja

getInherentHeight()

Powrót

Autoryzacja

getInherentWidth()

Powrót

Autoryzacja

getLeft()

Powrót

Autoryzacja

getLink()

Powrót

Autoryzacja

getObjectId()

Powrót

Autoryzacja

getPageElementType()

Powrót

Autoryzacja

getParentGroup()

Powrót

Autoryzacja

getParentPage()

Powrót

Autoryzacja

getParentPlaceholder()

Powrót

Autoryzacja

getPlaceholderIndex()

Powrót

Autoryzacja

getPlaceholderType()

Powrót

Autoryzacja

getRotation()

Powrót

Autoryzacja

getShapeType()

Powrót

getText()

Powrót

Autoryzacja

getTitle()

Powrót

Autoryzacja

Class Shape

`alignOnPage(alignmentPosition)`

`bringForward()`

`bringToFront()`

`duplicate()`

`getAutofit()`

`getBorder()`

`getConnectionSites()`

`getContentAlignment()`

`getDescription()`

`getFill()`

`getHeight()`

`getInherentHeight()`

`getInherentWidth()`

`getLeft()`

`getLink()`

`getObjectId()`

`getPageElementType()`

`getParentGroup()`

`getParentPage()`

`getParentPlaceholder()`

`getPlaceholderIndex()`

`getPlaceholderType()`

`getRotation()`

`getShapeType()`

`getText()`

`getTitle()`

`getTop()`

`getTransform()`

`getWidth()`

`preconcatenateTransform(transform)`

`remove()`

`removeLink()`

`replaceWithImage(blobSource)`

`replaceWithImage(blobSource, crop)`

`replaceWithImage(imageUrl)`

`replaceWithImage(imageUrl, crop)`

`replaceWithSheetsChart(sourceChart)`

`replaceWithSheetsChartAsImage(sourceChart)`

`scaleHeight(ratio)`

`scaleWidth(ratio)`

`select()`

`select(replace)`

`sendBackward()`

`sendToBack()`

`setContentAlignment(contentAlignment)`

`setDescription(description)`

`setHeight(height)`