Class Shape

kształt;

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

Metody

MetodaZwracany typKrótki opis
alignOnPage(alignmentPosition)ShapeWyrównuje element do określonego położenia wyrównania na stronie.
bringForward()ShapePrzesuwa element strony do przodu o jeden element.
bringToFront()ShapePrzenosi element strony na początek.
duplicate()PageElementPowiela element strony.
getAutofit()AutofitZwraca Autofit tekstu wewnątrz kształtu.
getBorder()BorderZwraca Border kształtu.
getConnectionSites()ConnectionSite[]Zwraca listę ConnectionSite w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn łączących.
getContentAlignment()ContentAlignmentZwraca ContentAlignment tekstu wskazanego w kształcie.
getDescription()StringZwraca opis tekstu alternatywnego elementu strony.
getFill()FillZwraca Fill kształtu.
getHeight()NumberPobiera wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie ma obrotu.
getInherentHeight()NumberZwraca całkowitą wysokość elementu w punktach.
getInherentWidth()NumberZwraca nieodłączną szerokość elementu w punktach.
getLeft()NumberZwraca pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został obracany.
getLink()LinkZwraca wartość Link lub null, jeśli nie ma linku.
getObjectId()StringZwraca unikalny identyfikator tego obiektu.
getPageElementType()PageElementTypeZwraca typ elementu strony (wyliczenie PageElementType).
getParentGroup()GroupZwraca grupę, do której należy ten element strony, lub null, jeśli element nie należy do grupy.
getParentPage()PageZwraca stronę, na której znajduje się ten element strony.
getParentPlaceholder()PageElementZwraca nadrzędny element strony obiektu zastępczego.
getPlaceholderIndex()IntegerZwraca indeks zastępczy kształtu.
getPlaceholderType()PlaceholderTypeZwraca typ symbolu zastępczego kształtu lub PlaceholderType.NONE, jeśli kształt nie jest obiektem zastępczym.
getRotation()NumberZwraca kąt obrotu elementu w prawo wokół jego środka wyrażony w stopniach, gdzie 0 stopni oznacza brak obrotu.
getShapeType()ShapeTypeZwraca typ kształtu.
getText()TextRangeZwraca zawartość tekstową kształtu.
getTitle()StringZwraca tytuł tekstu alternatywnego elementu strony.
getTop()NumberPobiera pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został obracany.
getTransform()AffineTransformZwraca przekształcenie elementu strony.
getWidth()NumberZwraca szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu.
preconcatenateTransform(transform)ShapeWstępnie łączy podane przekształcenie z istniejącym przekształceniem elementu strony.
remove()voidUsuwa element strony.
removeLink()voidUsuwa: Link.
replaceWithImage(blobSource)ImageZastępuje ten kształt obrazem dostarczonym przez BlobSource.
replaceWithImage(blobSource, crop)ImageZastępuje ten kształt obrazem dostarczonym przez BlobSource.
replaceWithImage(imageUrl)ImageZastępuje ten kształt obrazem.
replaceWithImage(imageUrl, crop)ImageZastępuje ten kształt obrazem.
replaceWithSheetsChart(sourceChart)SheetsChartZastępuje ten kształt wykresem z Arkuszy Google.
replaceWithSheetsChartAsImage(sourceChart)ImageZastępuje ten kształt obrazem wykresu z Arkuszy Google.
scaleHeight(ratio)ShapeSkaluje wysokość elementu o określony współczynnik.
scaleWidth(ratio)ShapeSkaluje szerokość elementu o określony współczynnik.
select()voidZaznacza tylko element PageElement w aktywnej prezentacji i usuwa wszystkie wcześniejsze zaznaczenie.
select(replace)voidZaznacza PageElement w aktywnej prezentacji.
sendBackward()ShapePrzesuwa element strony o jeden element wstecz.
sendToBack()ShapePrzenosi element strony na jej tył.
setContentAlignment(contentAlignment)ShapeUstawia ContentAlignment tekstu w kształcie.
setDescription(description)ShapeUstawia alternatywny opis tekstu elementu strony.
setHeight(height)ShapeUstawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie podlega obracaniu.
setLeft(left)ShapeUstawia pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie podlega obracaniu.
setLinkSlide(slideIndex)LinkUstawia w polu Link wartość Slide przy użyciu indeksu slajdu liczonego od zera.
setLinkSlide(slide)LinkUstawia w polu Link wartość Slide. Link jest ustawiany przez podany identyfikator slajdu.
setLinkSlide(slidePosition)LinkUstawia element Link na Slide przy użyciu względnego położenia slajdu.
setLinkUrl(url)LinkUstawia Link na podany niepusty ciąg adresu URL.
setRotation(angle)ShapeUstawia kąt obrotu elementu wokół jego środka w prawo w stopniach.
setTitle(title)ShapeUstawia tytuł tekstu alternatywnego elementu strony.
setTop(top)ShapeUstawia pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie jest obracany.
setTransform(transform)ShapeUstawia przekształcenie elementu strony przy użyciu podanego przekształcenia.
setWidth(width)ShapeUstawia szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu.

Szczegółowa dokumentacja

alignOnPage(alignmentPosition)

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

Parametry

NazwaTypOpis
alignmentPositionAlignmentPositionPozycja, do której ma zostać wyrównany ten element strony na stronie.

Powroty

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


bringForward()

Przesuwa element strony do przodu o jeden element.

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

Powroty

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

Upoważnienie

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

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

bringToFront()

Przenosi element strony na początek.

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

Powroty

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

Upoważnienie

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

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

duplicate()

Powiela element strony.

Zduplikowany element strony jest umieszczony na tej samej stronie w tym samym miejscu co strona oryginalna.

Powroty

PageElement – nowy duplikat danego elementu strony.

Upoważnienie

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

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

getAutofit()

Zwraca Autofit tekstu wewnątrz kształtu. Jeśli nie można wpisać tekstu, wartość ta będzie ustawiona na null.

Powroty

Autofit – automatyczne dopasowanie tekstu w obrębie kształtu.

Upoważnienie

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

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

getBorder()

Zwraca Border kształtu.

Powroty

Border – ustawienie obramowania dla kształtu.

Upoważnienie

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

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

getConnectionSites()

Zwraca listę ConnectionSite w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn łączących.

Powroty

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

Upoważnienie

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

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

getContentAlignment()

Zwraca ContentAlignment tekstu wskazanego w kształcie.

Powroty

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

Upoważnienie

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

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

getDescription()

Zwraca opis tekstu alternatywnego elementu strony. Opis jest łączony z tytułem, aby umożliwić wyświetlenie i odczytanie tekstu alternatywnego.

Powroty

String – opis tekstu alternatywnego elementu strony.

Upoważnienie

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

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

getFill()

Zwraca Fill kształtu.

Powroty

Fill – ustawienie wypełnienia danego kształtu.

Upoważnienie

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

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

getHeight()

Pobiera wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie ma obrotu.

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

Powroty

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

Upoważnienie

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

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

getInherentHeight()

Zwraca całkowitą wysokość elementu w punktach.

Przekształcenie elementu strony zależy od jego naturalnego rozmiaru. Użyj właściwego rozmiaru w połączeniu z transformacją elementu, aby określić ostateczny wygląd elementu.

Powroty

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

Upoważnienie

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

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

getInherentWidth()

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

Przekształcenie elementu strony zależy od jego naturalnego rozmiaru. Użyj właściwego rozmiaru w połączeniu z transformacją elementu, aby określić ostateczny wygląd elementu.

Powroty

Number – wewnętrzna szerokość elementu strony w punktach lub null, jeśli element strony nie ma szerokości.

Upoważnienie

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

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

getLeft()

Zwraca pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został obracany.

Powroty

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

Upoważnienie

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

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

Zwraca wartość 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());
}

Powroty

Link

Upoważnienie

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

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

getObjectId()

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

Powroty

String – unikalny identyfikator obiektu,

Upoważnienie

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

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

getPageElementType()

Zwraca typ elementu strony (wyliczenie PageElementType).

Powroty

PageElementType – typ elementu strony.

Upoważnienie

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

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

getParentGroup()

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

Powroty

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

Upoważnienie

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

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

getParentPage()

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

Powroty

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

Upoważnienie

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

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

getParentPlaceholder()

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

Powroty

PageElement – nadrzędny element strony danego obiektu zastępczego kształtu lub null, jeśli kształt nie jest obiektem zastępczym lub nie ma elementu nadrzędnego.

Upoważnienie

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

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

getPlaceholderIndex()

Zwraca indeks zastępczy kształtu. Jeśli na tej samej stronie znajdują się co najmniej 2 wystąpienia tego samego typu obiektów zastępczych, każdy z nich ma własną, unikalną wartość indeksu. Zwraca wartość null, jeśli kształt nie jest symbolem zastępczym.

Powroty

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

Upoważnienie

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

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

getPlaceholderType()

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

Powroty

PlaceholderType – typ symbolu zastępczego danego kształtu.

Upoważnienie

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

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

getRotation()

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

Powroty

Number – kąt obrotu w stopniach między 0 (włącznie) a 360 (bez tej wartości).

Upoważnienie

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

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

getShapeType()

Zwraca typ kształtu.

Powroty

ShapeType – typ danego kształtu.


getText()

Zwraca zawartość tekstową kształtu.

Tekst wewnątrz kształtu zawsze kończy się znakiem nowego wiersza.

Powroty

TextRange – zawartość tekstowa danego kształtu.

Upoważnienie

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

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

getTitle()

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

Powroty

String – tytuł tekstu alternatywnego elementu strony.

Upoważnienie

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

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

getTop()

Pobiera pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie został obracany.

Powroty

Number – położenie tego elementu w pionie (w punktach) od lewego górnego rogu strony.

Upoważnienie

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

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

getTransform()

Zwraca przekształcenie elementu strony.

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

Powroty

AffineTransform – przekształcenie elementu strony.

Upoważnienie

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

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

getWidth()

Zwraca szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu.

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

Powroty

Number – wewnętrzna szerokość elementu strony w punktach lub null, jeśli element strony nie ma szerokości.

Upoważnienie

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform

Aby na przykład przenieść elementy strony o 36 punktów w lewo:

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

Przekształcenie elementu strony możesz też zastąpić elementem setTransform(transform).

Parametry

NazwaTypOpis
transformAffineTransformTransformacja, która ma zostać wstępnie połączona z przekształceniem tego elementu strony.

Powroty

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

Upoważnienie

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

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

remove()

Usuwa element strony.

Jeśli po operacji usuwania element Group zawiera tylko jeden element strony lub nie zawiera go wcale, sama grupa również jest usuwana.

Jeśli z obiektu głównego lub układu zostanie usunięty obiekt zastępczy PageElement, wszystkie puste dziedziczące symbole zastępcze też zostaną usunięte.

Upoważnienie

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

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

Usuwa: Link.

shape.removeLink();

replaceWithImage(blobSource)

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

Podczas wstawiania obraz jest pobierany z przesłanego pliku BlobSource, a jego kopia jest przechowywana w celu wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie może przekraczać 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.

Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z rozmiarem 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

NazwaTypOpis
blobSourceBlobSourceDane obrazu.

Powroty

ImageImage, który zastąpił kształt.

Upoważnienie

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

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

replaceWithImage(blobSource, crop)

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

Wstawienie obrazu powoduje jednorazowe pobranie go z szablonu BlobSource i zapisanie jego kopii do wyświetlenia w prezentacji. Obrazy muszą być mniejsze niż 50 MB i nie mogą przekraczać 25 megapikseli, a także muszą 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

NazwaTypOpis
blobSourceBlobSourceDane obrazu.
cropBooleanJeśli wybierzesz true, obraz zostanie przycięty do rozmiaru istniejącego kształtu. W przeciwnym razie obraz zostanie przeskalowany i wyśrodkowany.

Powroty

ImageImage, który zastąpił kształt.

Upoważnienie

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

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

replaceWithImage(imageUrl)

Zastępuje ten kształt obrazem.

Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL, a jego kopia zostaje zapisana i wyświetlana w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także format PNG, JPEG lub GIF.

Podany adres URL musi być publicznie dostępny, a jego rozmiar nie może przekraczać 2 KB. Adres URL jest zapisywany wraz z obrazem i wyświetlany w elemencie Image.getSourceUrl().

Aby zachować współczynnik proporcji obrazu, jest on skalowany i wyśrodkowany zgodnie z rozmiarem istniejącego kształtu.

Parametry

NazwaTypOpis
imageUrlStringAdres URL obrazu, z którego ma zostać pobrany obraz.

Powroty

ImageImage, który zastąpił kształt.

Upoważnienie

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

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

replaceWithImage(imageUrl, crop)

Zastępuje ten kształt obrazem.

Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL, a jego kopia zostaje zapisana i wyświetlana w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB i nie może przekraczać 25 megapikseli, a także format PNG, JPEG lub GIF.

Podany adres URL nie może być większy niż 2 kB. Sam adres URL jest zapisywany wraz z obrazem i udostępniany przez funkcję Image.getSourceUrl().

Parametry

NazwaTypOpis
imageUrlStringAdres URL obrazu, z którego ma zostać pobrany obraz.
cropBooleanJeśli wybierzesz true, obraz zostanie przycięty do rozmiaru istniejącego kształtu. W przeciwnym razie obraz zostanie przeskalowany i wyśrodkowany.

Powroty

ImageImage, który zastąpił kształt.

Upoważnienie

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

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

replaceWithSheetsChart(sourceChart)

Zastępuje ten kształt wykresem z Arkuszy 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.

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

NazwaTypOpis
sourceChartEmbeddedChartWykres w arkuszu kalkulacyjnym, który zastępuje kształt.

Powroty

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

Upoważnienie

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

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

replaceWithSheetsChartAsImage(sourceChart)

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

Aby zachować współczynnik proporcji wykresu z Arkuszy Google, jest on przeskalowywany i wyśrodkowany zgodnie z rozmiarem istniejącego kształtu.

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

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

NazwaTypOpis
sourceChartEmbeddedChartWykres w arkuszu kalkulacyjnym, który zastępuje kształt.

Powroty

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

Upoważnienie

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

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

scaleHeight(ratio)

Skaluje wysokość elementu o określony współczynnik. Wysokość elementu to wysokość jego ramki ograniczającej, gdy element nie podlega obracaniu.

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

Parametry

NazwaTypOpis
ratioNumberWspółczynnik skalowania wysokości tego elementu strony.

Powroty

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

Upoważnienie

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

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

scaleWidth(ratio)

Skaluje szerokość elementu o określony współczynnik. Szerokość elementu to szerokość jego ramki ograniczającej, gdy element nie podlega obracaniu.

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

Parametry

NazwaTypOpis
ratioNumberWspółczynnik skalowania szerokości tego elementu strony.

Powroty

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

Upoważnienie

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

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

select()

Zaznacza tylko element PageElement w aktywnej prezentacji i usuwa wszystkie wcześniejsze zaznaczenie. Ta funkcja działa tak samo jak wywołanie select(replace) w aplikacji true.

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

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

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

Upoważnienie

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

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

select(replace)

Zaznacza PageElement w aktywnej prezentacji.

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

Przekaż true do tej metody, aby wybrać tylko PageElement i usunąć wcześniejsze zaznaczenie. Spowoduje to też ustawienie elementu nadrzędnego Page obiektu PageElement jako current page selection.

Przekazuj false, aby wybrać wiele obiektów PageElement. Obiekty PageElement muszą być w tej samej wartości Page.

Podczas wybierania elementu strony za pomocą parametru false muszą być spełnione te warunki:

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

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

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

Parametry

NazwaTypOpis
replaceBooleanJeśli ustawiona jest wartość true, wybór zastępuje dowolny wcześniej wybrany. W przeciwnym razie wybrany element zostanie dodany do dowolnego z wcześniejszych elementów.

Upoważnienie

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

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

sendBackward()

Przesuwa element strony o jeden element wstecz.

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

Powroty

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

Upoważnienie

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

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

sendToBack()

Przenosi element strony na jej tył.

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

Powroty

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

Upoważnienie

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

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

setContentAlignment(contentAlignment)

Ustawia ContentAlignment tekstu w kształcie.

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

Parametry

NazwaTypOpis
contentAlignmentContentAlignmentWyrównanie do ustawienia.

Powroty

Shape – ten kształt do wiązania.

Upoważnienie

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

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

setDescription(description)

Ustawia alternatywny opis tekstu elementu strony.

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

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

Parametry

NazwaTypOpis
descriptionStringCiąg, na który ma być ustawiony opis tekstu alternatywnego.

Powroty

Shape – ten element strony.

Upoważnienie

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

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

setHeight(height)

Ustawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej element, gdy element nie podlega obracaniu.

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

Parametry

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

Powroty

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

Upoważnienie

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

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

setLeft(left)

Ustawia pozycję elementu w poziomie w punktach mierzoną od lewego górnego rogu strony, gdy element nie podlega obracaniu.

Parametry

NazwaTypOpis
leftNumberNowa pozycja w poziomie do ustawienia w punktach.

Powroty

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

Upoważnienie

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

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

setLinkSlide(slideIndex)

Ustawia w polu Link wartość Slide przy użyciu indeksu slajdu liczonego od zera.

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

Parametry

NazwaTypOpis
slideIndexIntegerIndeks liczony od zera dla slajdu.

Powroty

Link – ustawiona wartość Link,

Upoważnienie

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

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

setLinkSlide(slide)

Ustawia w polu Link wartość Slide. 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

NazwaTypOpis
slideSlideSlide do połączenia.

Powroty

Link – ustawiona wartość Link,

Upoważnienie

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

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

setLinkSlide(slidePosition)

Ustawia element Link na Slide przy użyciu względnego położenia slajdu.

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

Parametry

NazwaTypOpis
slidePositionSlidePositionWzględny SlidePosition.

Powroty

Link – ustawiona wartość Link,

Upoważnienie

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

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

setLinkUrl(url)

Ustawia Link na podany niepusty ciąg adresu URL.

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

Parametry

NazwaTypOpis
urlStringCiąg adresu URL.

Powroty

Link – ustawiona wartość Link,

Upoważnienie

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

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

setRotation(angle)

Ustawia kąt obrotu elementu wokół jego środka w prawo w stopniach.

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

Parametry

NazwaTypOpis
angleNumberNowy kąt obrotu w prawo (w stopniach).

Powroty

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

Upoważnienie

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

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

setTitle(title)

Ustawia tytuł tekstu alternatywnego elementu strony.

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

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

Parametry

NazwaTypOpis
titleStringCiąg, na który ma zostać ustawiony tytuł tekstu alternatywnego.

Powroty

Shape – ten element strony.

Upoważnienie

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

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

setTop(top)

Ustawia pozycję elementu w pionie w punktach mierzoną od lewego górnego rogu strony, gdy element nie jest obracany.

Parametry

NazwaTypOpis
topNumberNowa pozycja w pionie do ustawienia w punktach.

Powroty

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

Upoważnienie

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

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

setTransform(transform)

Ustawia przekształcenie elementu strony przy użyciu podanego przekształcenia.

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

Aktualizowanie przekształcenia elementu strony, który należy do grupy, powoduje tylko zmianę przekształcenia tego elementu strony – nie ma wpływu na przekształcenia tej grupy ani innych elementów strony w tej grupie.

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

Parametry

NazwaTypOpis
transformAffineTransformPrzekształcenie ustawione dla tego elementu strony.

Powroty

Shape – element do tworzenia łańcuchów.

Upoważnienie

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

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

setWidth(width)

Ustawia szerokość elementu w punktach, czyli szerokość ramki ograniczającej element, gdy element nie podlega obracaniu.

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

Parametry

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

Powroty

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

Upoważnienie

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

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