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

Class Shape

PageElement reprezentujący ogólny kształt, który nie ma bardziej szczegółowych informacji klasyfikacja danych. 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ślonego położenia wyrównania na stronie.
`bringForward()`	`Shape`	Przesuwa element strony o jeden element do przodu.
`bringToFront()`	`Shape`	Przenosi element strony na początek.
`duplicate()`	`PageElement`	Powiela element strony.
`getAutofit()`	`Autofit`	Zwraca wartość `Autofit` tekstu w obrębie tego kształtu.
`getBorder()`	`Border`	Zwraca wartość `Border` kształtu.
`getConnectionSites()`	`ConnectionSite[]`	Zwraca listę elementów `ConnectionSite` w elemencie strony lub pustą listę, jeśli strona z elementem nie ma żadnych połączonych stron.
`getContentAlignment()`	`ContentAlignment`	Zwraca wartość `ContentAlignment` tekstu w kształcie.
`getDescription()`	`String`	Zwraca opis tekstowy elementu strony.
`getFill()`	`Fill`	Zwraca wartość `Fill` kształtu.
`getHeight()`	`Number`	Pobiera wysokość elementu w punktach, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji.
`getInherentHeight()`	`Number`	Zwraca nieodłączną wysokość elementu podaną w punktach.
`getInherentWidth()`	`Number`	Zwraca nieodłączną szerokość elementu w punktach.
`getLeft()`	`Number`	Zwraca w punktach pozycję poziomą elementu mierzoną od lewego górnego rogu elementu strony, gdy element nie ma rotacji.
`getLink()`	`Link`	Zwraca `Link` lub `null`, jeśli nie ma linku.
`getObjectId()`	`String`	Zwraca unikalny identyfikator obiektu.
`getPageElementType()`	`PageElementType`	Zwraca typ elementu strony reprezentowany jako wyliczenie `PageElementType`.
`getParentGroup()`	`Group`	Zwraca grupę, do której należy ten element strony, lub `null`, jeśli element nie znajduje się w grupy reklam.
`getParentPage()`	`Page`	Zwraca stronę, na której znajduje się ten element strony.
`getParentPlaceholder()`	`PageElement`	Zwraca nadrzędny element strony dla obiektu zastępczego.
`getPlaceholderIndex()`	`Integer`	Zwraca indeks zastępczy kształtu.
`getPlaceholderType()`	`PlaceholderType`	Zwraca typ obiektu zastępczego kształtu lub wartość `PlaceholderType.NONE`, jeśli kształt nie jest odpowiedni obiekt zastępczy.
`getRotation()`	`Number`	Zwraca kąt obrotu elementu w prawo wokół jego środka, gdzie 0 stopni oznacza brak rotacji.
`getShapeType()`	`ShapeType`	Zwraca typ kształtu.
`getText()`	`TextRange`	Zwraca zawartość tekstową kształtu.
`getTitle()`	`String`	Zwraca tytuł tekstu alternatywnego elementu strony.
`getTop()`	`Number`	Pobiera pionową pozycję elementu w punktach zmierzoną od lewego górnego rogu strony gdy element nie ma rotacji.
`getTransform()`	`AffineTransform`	Zwraca przekształcenie elementu strony.
`getWidth()`	`Number`	Zwraca szerokość elementu w punktach, która jest szerokością ramki ograniczającej elementu, gdy element nie ma rotacji.
`preconcatenateTransform(transform)`	`Shape`	Wstępnie łączy podane przekształcenie z istniejącym przekształceniem elementu strony.
`remove()`	`void`	Usuwa element strony.
`removeLink()`	`void`	Usuwa element `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 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`	Wybiera tylko element `PageElement` w aktywnej prezentacji i usuwa wszystkie poprzednie wyboru.
`select(replace)`	`void`	Wybiera element `PageElement` w aktywnej prezentacji.
`sendBackward()`	`Shape`	Przesuwa element strony o jeden element wstecz.
`sendToBack()`	`Shape`	Przesuwa element strony na tylną część 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, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji.
`setLeft(left)`	`Shape`	Określa pozycję elementu w poziomie w punktach, mierzoną od lewego górnego rogu elementu strony, gdy element nie ma rotacji.
`setLinkSlide(slideIndex)`	`Link`	Ustawia `Link` na podaną wartość `Slide` za pomocą indeksu slajdu liczony od zera.
`setLinkSlide(slide)`	`Link`	Ustawia element `Link` na podany element `Slide`, a link jest ustawiany przez podany identyfikator slajdu.
`setLinkSlide(slidePosition)`	`Link`	Ustawia `Link` na podaną wartość `Slide` na podstawie względnej pozycji slajdu.
`setLinkUrl(url)`	`Link`	Ustawia wartość `Link` na dany ciąg znaków adresu URL, który nie jest pusty.
`setRotation(angle)`	`Shape`	Ustawia kąt obrotu elementu w prawo dookoła jego środka (w stopniach).
`setTitle(title)`	`Shape`	Ustawia tytuł tekstu alternatywnego elementu strony.
`setTop(top)`	`Shape`	Określa pozycję elementu w pionie w punktach, zmierzoną od lewego górnego rogu strony gdy element nie ma rotacji.
`setTransform(transform)`	`Shape`	Ustawia przekształcenie elementu strony za pomocą podanego przekształcenia.
`setWidth(width)`	`Shape`	Ustawia szerokość elementu w punktach, która jest szerokością ramki ograniczającej elementu, gdy Element nie ma rotacji.

Szczegółowa dokumentacja

`alignOnPage(alignmentPosition)`

Wyrównuje element do określonego położenia wyrównania na stronie.

Parametry

Nazwa	Typ	Opis
`alignmentPosition`	`AlignmentPosition`	Położenie, do którego ma zostać wyrównany ten element strony.

Powrót

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

`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żący do tworzenia łańcuchów.

Autoryzacja

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

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

`bringToFront()`

Przenosi element strony na początek.

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

Powrót

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

Autoryzacja

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

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

`duplicate()`

Powiela element strony.

Zduplikowany element strony jest umieszczany na tej samej stronie i w tym samym położeniu co oryginał.

Powrót

PageElement – nowy duplikat tego elementu strony.

Autoryzacja

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

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

`getAutofit()`

Zwraca wartość Autofit tekstu w obrębie tego kształtu. Jest to null, jeśli kształt nie można wysyłać SMS-ów.

Powrót

Autofit – automatyczne dopasowanie tekstu w danym kształcie.

Autoryzacja

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

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

`getBorder()`

Zwraca wartość Border kształtu.

Powrót

Border – ustawienie obramowania dla tego kształtu

Autoryzacja

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

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

`getConnectionSites()`

Zwraca listę elementów ConnectionSite w elemencie strony lub pustą listę, jeśli strona z elementem nie ma żadnych połączonych stron.

Powrót

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

Autoryzacja

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

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

`getContentAlignment()`

Zwraca wartość ContentAlignment tekstu w kształcie.

Powrót

ContentAlignment – wyrównanie tekstu w obrębie kształtu.

Autoryzacja

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

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

`getDescription()`

Zwraca opis tekstowy elementu strony. Opis jest połączony z tytułem wyświetlania i odczytywania tekstu alternatywnego.

Powrót

String – opis tekstu alternatywnego elementu strony.

Autoryzacja

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

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

`getFill()`

Zwraca wartość Fill kształtu.

Powrót

Fill – ustawienie wypełnienia kształtu.

Autoryzacja

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

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

`getHeight()`

Pobiera wysokość elementu w punktach, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Powrót

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

Autoryzacja

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

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

`getInherentHeight()`

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

Przekształcenie elementu strony zależy od jego rozmiaru. Używaj właściwego rozmiaru w wraz z przekształceniem elementu, aby określić jego ostateczny wygląd.

Powrót

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

Autoryzacja

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

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

`getInherentWidth()`

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

Przekształcenie elementu strony zależy od jego rozmiaru. Używaj właściwego rozmiaru w wraz z przekształceniem elementu, aby określić jego ostateczny wygląd.

Powrót

Number – maksymalna szerokość elementu strony podana w punktach lub null, jeśli element strony ma tak nie mają szerokości.

Autoryzacja

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

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

`getLeft()`

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

Powrót

Number – położenie tego elementu w poziomie w punktach w lewym górnym rogu strony.

Autoryzacja

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

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

`getLink()`

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

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

Powrót

Link

Autoryzacja

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

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

`getObjectId()`

Zwraca unikalny identyfikator obiektu. Identyfikatory obiektów używane przez strony i ich elementy mają ten sam identyfikator w tej samej przestrzeni nazw.

Powrót

String – unikalny identyfikator obiektu.

Autoryzacja

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

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

`getPageElementType()`

Zwraca typ elementu strony reprezentowany jako wyliczenie PageElementType.

Powrót

PageElementType – typ elementu strony.

Autoryzacja

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

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

`getParentGroup()`

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

Powrót

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

Autoryzacja

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

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

`getParentPage()`

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

Powrót

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

Autoryzacja

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

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

`getParentPlaceholder()`

Zwraca nadrzędny element strony dla obiektu zastępczego. Zwraca null, jeśli kształt nie jest zastępczego lub bez elementu nadrzędnego.

Powrót

PageElement – nadrzędny element strony tego obiektu zastępczego kształtu (lub null, jeśli ten kształt nie jest). jest zmienna lub nie ma elementu nadrzędnego.

Autoryzacja

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

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

`getPlaceholderIndex()`

Zwraca indeks zastępczy kształtu. Co najmniej 2 wystąpienia tego samego symbolu zastępczego znajdują się na tej samej stronie, każdy z nich ma własną, unikalną wartość indeksu. Zwraca wartość null, jeśli kształt nie jest obiektem zastępczym.

Powrót

Integer – indeks obiektu zastępczego tego kształtu lub wartość null, jeśli kształt nie jest obiektem zastępczym.

Autoryzacja

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

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

`getPlaceholderType()`

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

Powrót

PlaceholderType – typ obiektu zastępczego kształtu.

Autoryzacja

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

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

`getRotation()`

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

Powrót

Number – kąt obrotu w stopniach od 0 (włącznie) do 360 (bez tej wartości).

Autoryzacja

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

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

`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 danego kształtu,

Autoryzacja

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

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

`getTitle()`

Zwraca tytuł tekstu alternatywnego elementu strony. Tytuł jest połączony z opisem, aby wyświetlania i odczytywania tekstu alternatywnego.

Powrót

String – tytuł tekstu alternatywnego elementu strony.

Autoryzacja

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

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

`getTop()`

Pobiera pionową pozycję elementu w punktach zmierzoną od lewego górnego rogu strony gdy element nie ma rotacji.

Powrót

Number – położenie tego elementu w pionie w punktach w lewym górnym rogu strony.

Autoryzacja

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

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

`getTransform()`

Zwraca przekształcenie elementu strony.

Wygląd elementu strony zależy od jego przekształcenia bezwzględnego. Do obliczanie przekształcenia bezwzględnego, wstępne łączenie przekształcenia elementu strony z przekształceniami wszystkich swoich grup nadrzędnych. Jeśli element strony nie należy do grupy, jego przekształcenie bezwzględne ma postać taka sama jak wartość w tym polu.

Powrót

AffineTransform – przekształcenie elementu strony.

Autoryzacja

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

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

`getWidth()`

Zwraca szerokość elementu w punktach, która jest szerokością ramki ograniczającej elementu, gdy element nie ma rotacji.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Powrót

Number – maksymalna szerokość elementu strony podana w punktach lub null, jeśli element strony ma tak nie mają szerokości.

Autoryzacja

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

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

`preconcatenateTransform(transform)`

Wstępnie łączy podane przekształcenie z istniejącym przekształceniem elementu strony.

newTransform = argument * existingTransform

Aby np. przenieść elementy strony o 36 punktów w lewo:

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

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

Parametry

Nazwa	Typ	Opis
`transform`	`AffineTransform`	Przekształcenie, które zostanie wstępnie powiązane z przekształceniem tego elementu strony.

Powrót

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

Autoryzacja

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

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

`remove()`

Usuwa element strony.

Jeśli po operacji usuwania element Group zawiera tylko jeden element strony lub nie zawiera go, w parametrze samej grupy zostanie również usunięta.

Jeśli obiekt zastępczy PageElement zostanie usunięty z elementu głównego lub układu, wszystkie puste elementy dziedziczenia zmienne również są usuwane.

Autoryzacja

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

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

`removeLink()`

Usuwa element Link.

shape.removeLink();

`replaceWithImage(blobSource)`

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

Obraz jest pobierany z podanego przez użytkownika BlobSource raz w momencie wstawiania i kopie jest zapisywany i wyświetlany w prezentacji. Rozmiar obrazu nie może przekraczać 50 MB. musi być większy niż 25 megapikseli i musi być w formacie PNG, JPEG lub GIF.

Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z założeniami do rozmiaru istniejącego kształtu.

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

Parametry

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

Powrót

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

Autoryzacja

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

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

`replaceWithImage(blobSource, crop)`

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

Wstawienie obrazu powoduje jego pobranie z BlobSource, a kopia jest przechowywana przez które będą widoczne w prezentacji. Rozmiar obrazu nie może przekraczać 50 MB, ale nie może przekraczać 25 MB megapikseli i musi być w formacie PNG, JPEG lub GIF.

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

Parametry

Nazwa	Typ	Opis
`blobSource`	`BlobSource`	Dane obrazu.
`crop`	`Boolean`	W przypadku opcji `true` obraz zostanie przycięty, aby dopasować go do obecnego kształtu. W przeciwnym razie obraz jest przeskalowany i wyśrodkowany.

Powrót

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

Autoryzacja

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

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

`replaceWithImage(imageUrl)`

Zastępuje ten kształt obrazem.

Wstawienie obrazu powoduje jego pobranie z adresu URL tylko raz, a jego kopia jest zapisywana w celu wyświetlenia prezentacji. Rozmiar zdjęć nie może przekraczać 50 MB, nie może przekraczać 25 megapikseli. być w formacie PNG, JPEG lub GIF.

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

Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z założeniami do rozmiaru istniejącego kształtu.

Parametry

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

Powrót

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

Autoryzacja

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

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

`replaceWithImage(imageUrl, crop)`

Zastępuje ten kształt obrazem.

Podany adres URL nie może być większy niż 2 kB. Sam URL jest zapisywany razem z obrazem, widoczne w okresie Image.getSourceUrl().

Parametry

Nazwa	Typ	Opis
`imageUrl`	`String`	Adres URL obrazu, z którego można go pobrać.
`crop`	`Boolean`	W przypadku opcji `true` obraz zostanie przycięty, aby dopasować go do obecnego kształtu. W przeciwnym razie obraz jest przeskalowany i wyśrodkowany.

Powrót

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

Autoryzacja

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

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

`replaceWithSheetsChart(sourceChart)`

Zastępuje ten kształt wykresem z Arkuszy Google.

Wykres jest połączony ze źródłowym wykresem Arkuszy Google, który można zaktualizować. Inny powód współpracownicy mogą zobaczyć link do źródłowego arkusza kalkulacyjnego.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var 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 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 z Arkuszy Google.

Aby zachować współczynnik proporcji wykresu z Arkuszy Google, obraz na wykresie jest skalowany wyśrodkowany względem rozmiaru istniejącego kształtu.

Obraz tego wykresu nie jest połączony z wykresem w Arkuszach Google źródłowego.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var 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 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 według określonego współczynnika. Wysokość elementu to wysokość jego ramkę ograniczającą, gdy element nie jest objęty obrotem.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Parametry

Nazwa	Typ	Opis
`ratio`	`Number`	Współczynnik skalowania wysokości tego elementu strony.

Powrót

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

Autoryzacja

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

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

`scaleWidth(ratio)`

Skaluje szerokość elementu według określonego współczynnika. Szerokość elementu to szerokość jego ramkę ograniczającą, gdy element nie jest objęty obrotem.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Parametry

Nazwa	Typ	Opis
`ratio`	`Number`	Współczynnik skalowania szerokości tego elementu strony.

Powrót

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

Autoryzacja

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

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

`select()`

Wybiera tylko element PageElement w aktywnej prezentacji i usuwa wszystkie poprzednie wyboru. Ta funkcja działa tak samo, jak nawiązanie połączenia z numerem select(replace) w aplikacji true.

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

Ustawia nadrzędny Page elementu PageElement na current page selection.

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

Autoryzacja

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

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

`select(replace)`

Wybiera element PageElement w aktywnej prezentacji.

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

Przekaż true do tej metody, aby wybrać tylko PageElement i usunąć pozostałe poprzedniego wyboru. Spowoduje to również ustawienie nadrzędnego Page obiektu PageElement jako current page selection

Aby wybrać kilka obiektów PageElement, miń false. PageElement obiekty muszą być w tym samym obiekcie Page.

Podczas wybierania elementu strony za pomocą false muszą być spełnione poniższe warunki :

Elementem nadrzędnym Page obiektu PageElement musi być current page selection.
Nie można zaznaczyć wielu obiektów Page.

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

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

Parametry

Nazwa	Typ	Opis
`replace`	`Boolean`	Jeśli `true`, zastąpi dowolny poprzedni wybór; w przeciwnym razie zostanie dodany do wcześniejszego zaznaczenia.

Autoryzacja

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

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

`sendBackward()`

Przesuwa element strony o jeden element wstecz.

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

Powrót

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

Autoryzacja

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

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

`sendToBack()`

Przesuwa element strony na tylną część strony.

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

Powrót

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

Autoryzacja

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

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

`setContentAlignment(contentAlignment)`

Ustawia ContentAlignment tekstu w kształcie.

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

Parametry

Nazwa	Typ	Opis
`contentAlignment`	`ContentAlignment`	Wyrównanie do ustawienia.

Powrót

Shape – kształt do łańcuchów.

Autoryzacja

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

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

`setDescription(description)`

Ustawia 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".
var 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, dla którego ma zostać ustawiony tekst alternatywny opisu.

Powrót

Shape – ten element strony.

Autoryzacja

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

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

`setHeight(height)`

Ustawia wysokość elementu w punktach, która jest wysokością ramki ograniczającej elementu, gdy Element nie ma rotacji.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Parametry

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

Powrót

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

Autoryzacja

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

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

`setLeft(left)`

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

Parametry

Nazwa	Typ	Opis
`left`	`Number`	Nowa pozycja w poziomie do ustawienia (w punktach).

Powrót

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

Autoryzacja

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

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

`setLinkSlide(slideIndex)`

Ustawia Link na podaną wartość Slide za pomocą indeksu slajdu liczony od zera.

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

Parametry

Nazwa	Typ	Opis
`slideIndex`	`Integer`	Indeks liczony od zera dla slajdu.

Powrót

Link – Link, który został ustawiony;

Autoryzacja

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

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

`setLinkSlide(slide)`

Ustawia element Link na podany element Slide, a link jest ustawiany przez podany identyfikator slajdu.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Parametry

Nazwa	Typ	Opis
`slide`	`Slide`	`Slide` do połączenia.

Powrót

Link – Link, który został ustawiony;

Autoryzacja

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

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

`setLinkSlide(slidePosition)`

Ustawia Link na podaną wartość Slide na podstawie względnej pozycji slajdu.

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

Parametry

Nazwa	Typ	Opis
`slidePosition`	`SlidePosition`	Względna wartość `SlidePosition`.

Powrót

Link – Link, który został ustawiony;

Autoryzacja

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

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

`setLinkUrl(url)`

Ustawia wartość Link na dany ciąg znaków adresu URL, który nie jest pusty.

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

Parametry

Nazwa	Typ	Opis
`url`	`String`	Ciąg adresu URL.

Powrót

Link – Link, który został ustawiony;

Autoryzacja

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

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

`setRotation(angle)`

Ustawia kąt obrotu elementu w prawo dookoła jego środka (w stopniach).

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Parametry

Nazwa	Typ	Opis
`angle`	`Number`	Nowy kąt obrotu w prawo do ustawienia w stopniach.

Powrót

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

Autoryzacja

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

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

`setTitle(title)`

Ustawia tytuł tekstu alternatywnego elementu strony.

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

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parametry

Nazwa	Typ	Opis
`title`	`String`	Ciąg, dla którego należy ustawić tytuł tekstu alternatywnego.

Powrót

Shape – ten element strony.

Autoryzacja

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

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

`setTop(top)`

Określa pozycję elementu w pionie w punktach, zmierzoną od lewego górnego rogu strony gdy element nie ma rotacji.

Parametry

Nazwa	Typ	Opis
`top`	`Number`	Nowa pozycja w pionie do ustawienia (w punktach).

Powrót

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

Autoryzacja

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

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

`setTransform(transform)`

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

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

Aktualizacja przekształcenia elementu strony, który należy do grupy, zmienia tylko przekształcenie ten element strony; Nie ma to wpływu na przekształcenia grupy ani innych elementów strony w grupy reklam.

Szczegółowe informacje na temat wpływu przekształceń na wygląd elementów strony znajdziesz na stronie getTransform().

Parametry

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

Powrót

Shape – ten element służy do tworzenia łańcuchów.

Autoryzacja

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

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

`setWidth(width)`

Ustawia szerokość elementu w punktach, która jest szerokością ramki ograniczającej elementu, gdy Element nie ma rotacji.

Ta metoda nie jest zgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony zgodne z tą metodą, zapoznaj się z ograniczeń rozmiaru i pozycjonowania.

Parametry

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

Powrót

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

Autoryzacja

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

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