Class Shape

Kształt

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

Metody

MetodaZwracany typKrótki opis
alignOnPage(alignmentPosition)ShapeWyrównuje element względem określonej pozycji na stronie.
bringForward()ShapePowoduje przesuwanie elementu na stronie do przodu o 1 element.
bringToFront()ShapePrzenosi element strony na początek strony.
duplicate()PageElementDuplikuje element strony.
getAutofit()AutofitZwraca Autofit tekstu w tym kształcie.
getBorder()BorderZwraca Border kształtu.
getConnectionSites()ConnectionSite[]Zwraca listę elementów ConnectionSite w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn połączenia.
getContentAlignment()ContentAlignmentZwraca ContentAlignment tekstu w kształcie.
getDescription()StringZwraca tekst alternatywny tekstu elementu strony.
getFill()FillZwraca Fill kształtu.
getHeight()NumberPobiera wysokość punktów w punktach, czyli wysokość ramki ograniczającej elementu, gdy element nie ma obrotu.
getInherentHeight()NumberZwraca unikalną wysokość elementu w punktach.
getInherentWidth()NumberZwraca wewnętrzną szerokość elementu w punktach.
getLeft()NumberZwraca poziomą pozycję elementu w punktach mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.
getLink()LinkZwraca wartość Link lub null, jeśli nie ma linku.
getObjectId()StringZwraca unikalny identyfikator tego obiektu.
getPageElementType()PageElementTypeZwraca typ elementu strony wyrażony w postaci wyliczenia PageElementType.
getParentGroup()GroupZwraca grupę, do której należy ten element strony, lub wartość null, jeśli elementu nie ma w grupie.
getParentPage()PageZwraca stronę, na której znajduje się ten element strony.
getParentPlaceholder()PageElementZwraca element nadrzędny strony zastępczej.
getPlaceholderIndex()IntegerZwraca indeks zastępczy kształtu.
getPlaceholderType()PlaceholderTypeZwraca typ obiektu zastępczego kształtu lub PlaceholderType.NONE, jeśli kształt nie jest symbolem zastępczym.
getRotation()NumberZwraca kąt obrotu w prawo o stopnie (w stopniach), przy czym zero stopni oznacza brak obrotu.
getShapeType()ShapeTypeZwraca typ kształtu.
getText()TextRangeZwraca zawartość tekstową kształtu.
getTitle()StringZwraca tytuł tekstu alternatywnego elementu strony.
getTop()NumberPobiera w pionie pozycję elementu mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.
getTransform()AffineTransformZwraca przekształcenie elementu strony.
getWidth()NumberZwraca szerokość elementu w punktach, czyli szerokość ramki ograniczającej elementu, gdy element nie ma obrotu.
preconcatenateTransform(transform)ShapeŁączy wstępnie przekształconą wartość z dotychczasowym przekształceniem elementu strony.
remove()voidUsuwa element strony.
removeLink()voidUsuwa Link.
replaceWithImage(blobSource)ImageZastępuje ten kształt obrazem pochodzącym z usługi BlobSource.
replaceWithImage(blobSource, crop)ImageZastępuje ten kształt obrazem pochodzącym z usługi 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 z Arkuszy Google.
scaleHeight(ratio)ShapeSkaluje wysokość elementu o określony współczynnik.
scaleWidth(ratio)ShapeSkaluje szerokość elementu o określony współczynnik.
select()voidWybiera tylko PageElement w aktywnej prezentacji i usuwa poprzednie zaznaczenie.
select(replace)voidZaznacza element PageElement w aktywnej prezentacji.
sendBackward()ShapeWysyła jeden element na stronie wstecz.
sendToBack()ShapeWysyła element strony z tyłu strony.
setContentAlignment(contentAlignment)ShapeUstawia ContentAlignment tekstu w kształcie.
setDescription(description)ShapeUstawia tekst alternatywny elementu strony.
setHeight(height)ShapeUstawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej elementu, gdy element nie jest obrócony.
setLeft(left)ShapeUstawia poziomą pozycję elementu w punktach mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.
setLinkSlide(slideIndex)LinkUstawia wartość Link dla podanego parametru Slide przy użyciu indeksu opartego na zerze.
setLinkSlide(slide)LinkUstawia wartość Link dla podanego elementu Slide. Link jest ustawiany przez podany identyfikator slajdu.
setLinkSlide(slidePosition)LinkUstawia atrybut Link na określoną wartość Slide przy użyciu względnej pozycji slajdu.
setLinkUrl(url)LinkUstawia wartość Link dla danego niepustego ciągu adresu URL.
setRotation(angle)ShapeUstawia kąt obrotu elementu w prawo o stopnie.
setTitle(title)ShapeUstawia tytuł alternatywny tekstu elementu strony.
setTop(top)ShapeOkreśla w pionie pozycję elementu mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.
setTransform(transform)ShapeUstawia przekształcenie elementu strony z użyciem tego przekształcenia.
setWidth(width)ShapeOkreśla szerokość elementu w punktach, czyli szerokość ramki ograniczającej elementu, gdy element nie ma obrotu.

Szczegółowa dokumentacja

alignOnPage(alignmentPosition)

Wyrównuje element względem określonej pozycji na stronie.

Parametry

NazwaTypOpis
alignmentPositionAlignmentPositionPozycja wyrównania tego elementu strony na stronie.

Zwróć

Shape – ten element strony na potrzeby łańcucha.


bringForward()

Powoduje przesuwanie elementu na stronie do przodu o 1 element.

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

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

bringToFront()

Przenosi element strony na początek strony.

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

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 umieszczony na tej samej stronie w tej samej pozycji co oryginał.

Zwróć

PageElement – nowy duplikat tego elementu strony.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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.

Zwróć

Autofit – automatyczne dopasowanie tekstu w tym kształcie.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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.

Zwróć

Border – ustawienie obramowania tego kształtu.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn połączenia.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getDescription()

Zwraca tekst alternatywny tekstu elementu strony. Opis jest połączony z tytułem, aby wyświetlać i czytać tekst alternatywny.

Zwróć

String – opis alternatywny tekstu elementu strony.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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.

Zwróć

Fill – ustawienie wypełnienia tego kształtu,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getHeight()

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

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getInherentHeight()

Zwraca unikalną wysokość elementu w punktach.

Przekształcenie elementu strony jest zależne od jego nieodłącznego rozmiaru. Aby określić ostateczny wygląd elementu, użyj przekształcenia rozmiaru w połączeniu z transformacją elementu.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getInherentWidth()

Zwraca wewnętrzną szerokość elementu w punktach.

Przekształcenie elementu strony jest zależne od jego nieodłącznego rozmiaru. Aby określić ostateczny wygląd elementu, użyj przekształcenia rozmiaru w połączeniu z transformacją elementu.

Zwróć

Number – rzeczywista szerokość elementu strony podana w punktach, a null, jeśli element strony nie ma szerokości.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 ma obrotu.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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());
}

Zwróć

Link

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 ich elementy mają taką samą przestrzeń nazw.

Zwróć

String – unikalny identyfikator tego obiektu;

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 wyrażony w postaci wyliczenia PageElementType.

Zwróć

PageElementType – typ elementu strony,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 wartość null, jeśli elementu nie ma w grupie.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getParentPlaceholder()

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

Zwróć

PageElement – element nadrzędny elementu zastępczego tego kształtu lub null, jeśli nie jest on obiektem zastępczym lub nie ma elementu nadrzędnego;

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 obiektu zastępczego, każdy z nich ma własną unikalną wartość indeksu. Zwraca wartość null, jeśli kształt nie jest symbolem zastępczym.

Zwróć

Integer – indeks zmiennej, a null – jeśli kształt nie jest symbolem zastępczym.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 symbolem zastępczym.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 w prawo o stopnie (w stopniach), przy czym zero stopni oznacza brak obrotu.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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.

Zwróć

ShapeType – typ tego kształtu,


getText()

Zwraca zawartość tekstową kształtu.

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

Zwróć

TextRange – zawartość tego kształtu.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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ł zostaje połączony z opisem, aby wyświetlać i czytać tekst alternatywny.

Zwróć

String – tytuł alternatywnego tekstu elementu strony.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getTop()

Pobiera w pionie pozycję elementu mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu.

Zwróć

Number – umiejscowienie tego elementu w punktach, w lewym górnym rogu strony;

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 na podstawie przekształcenia bezwzględnego. Aby obliczyć współczynnik bezwzględny, przełącz transformację elementu strony ze zmianami we wszystkich jego grupach nadrzędnych. Jeśli element strony nie znajduje się w grupie, jego bezwzględna przekształcenie jest taka sama jak wartość w tym polu.

Zwróć

AffineTransform – przekształcenie elementu strony.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 ma obrotu.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Zwróć

Number – rzeczywista szerokość elementu strony podana w punktach, a null, jeśli element strony nie ma szerokości.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

preconcatenateTransform(transform)

Łączy wstępnie przekształconą wartość z dotychczasowym 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());

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

Parametry

NazwaTypOpis
transformAffineTransformPrzekształcenie odpowiadające wstępnie przekształceniu tego elementu strony.

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 tag Group zawiera tylko 1 element strony lub nie zawiera go wcale, ta grupa też zostanie usunięta.

Jeśli obiekt zastępczy PageElement zostanie usunięty z szablonu głównego lub układu, zostaną też usunięte wszystkie puste obiekty dziedziczone.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego 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 pochodzącym z usługi BlobSource.

Obraz jest pobierany z podanego BlobSource podczas razowego wstawiania i jest przechowywany do wyświetlenia w prezentacji. Rozmiar obrazu nie może przekraczać 50 MB, nie może on być większy niż 25 megapikseli oraz musi być w formacie PNG, JPEG lub GIF.

Aby zachować współczynnik proporcji obrazu, jest on przeskalowany i wyśrodkowany względem 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

NazwaTypOpis
blobSourceBlobSourceDane obrazu.

Zwróć

ImageImage, które zastąpiło kształt.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 pochodzącym z usługi BlobSource.

Wstawianie obrazu pobiera się raz z BlobSource, a jego kopia jest przechowywana w celu wyświetlenia w prezentacji Rozmiar obrazu nie może przekraczać 50 MB, nie może on przekraczać 25 megapikseli oraz 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

NazwaTypOpis
blobSourceBlobSourceDane obrazu.
cropBooleanJeśli true ma przycięcie, obraz jest dopasowany do rozmiaru istniejącego kształtu. W przeciwnym razie obraz jest skalowany i wyśrodkowany.

Zwróć

ImageImage, które zastąpiło kształt.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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, a kopia jest przechowywana w celu wyświetlenia w ramach prezentacji. Obrazy nie mogą być większe niż 50 MB, nie mogą być większe niż 25 megapikseli oraz 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ą tagu Image.getSourceUrl().

Aby zachować współczynnik proporcji obrazu, jest on przeskalowany i wyśrodkowany względem rozmiaru istniejącego kształtu.

Parametry

NazwaTypOpis
imageUrlStringAdres URL obrazu, z którego można go pobrać.

Zwróć

ImageImage, które zastąpiło kształt.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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.

Wstawienie obrazu powoduje jednorazowe pobranie go z adresu URL, a kopia jest przechowywana w celu wyświetlenia w ramach prezentacji. Obrazy nie mogą być większe niż 50 MB, nie mogą być większe niż 25 megapikseli oraz muszą być w formacie PNG, JPEG lub GIF.

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

Parametry

NazwaTypOpis
imageUrlStringAdres URL obrazu, z którego można go pobrać.
cropBooleanJeśli true ma przycięcie, obraz jest dopasowany do rozmiaru istniejącego kształtu. W przeciwnym razie obraz jest skalowany i wyśrodkowany.

Zwróć

ImageImage, które zastąpiło kształt.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 w Arkuszach Google, który umożliwia jego aktualizację. 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.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 z Arkuszy Google.

Aby zachować współczynnik proporcji wykresu w Arkuszach Google, obraz jest przeskalowany i wyśrodkowany względem rozmiaru istniejącego kształtu.

Obraz wykresu nie jest powiązany ze źródłowym wykresem 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.

Zwróć

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

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 o określony współczynnik. Wysokość elementu to wysokość ramki ograniczającej, gdy element nie ma obrotów.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Parametry

NazwaTypOpis
ratioNumberWspółczynnik służący do skalowania wysokości tego elementu strony.

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 o określony współczynnik. Szerokość elementu to szerokość ramki ograniczającej, gdy element nie jest obrócony.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Parametry

NazwaTypOpis
ratioNumberWspółczynnik służący do skalowania szerokości tego elementu strony.

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

select()

Wybiera tylko PageElement w aktywnej prezentacji i usuwa poprzednie zaznaczenie. Działa to tak samo, jak dzwonię pod numer select(replace) za pomocą numeru true.

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

Spowoduje to ustawienie elementu nadrzędnego Page elementu 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, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

select(replace)

Zaznacza element PageElement w aktywnej prezentacji.

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

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

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

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

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

Aby to zrobić, wybierz najpierw element nadrzędny Page przy użyciu Page.selectAsCurrentPage(), a potem 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 wybierzesz true, wybór zastąpi wcześniejszy wybór. W przeciwnym razie wybór zostanie dodany do poprzedniego.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

sendBackward()

Wysyła jeden element na stronie wstecz.

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

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

sendToBack()

Wysyła element strony z tyłu strony.

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

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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

NazwaTypOpis
contentAlignmentContentAlignmentWyrównanie do ustawienia.

Zwróć

Shape – ten kształt służy do łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parametry

NazwaTypOpis
descriptionStringCiąg znaków, do którego ma zostać wysłany opis alternatywny.

Zwróć

Shape – ten element strony,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 elementu, gdy element nie jest obrócony.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Parametry

NazwaTypOpis
heightNumberNowa wysokość tego elementu strony, którą chcesz ustawić, w punktach.

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

setLeft(left)

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

Parametry

NazwaTypOpis
leftNumberNowa pozycja pozioma do ustawienia w punktach.

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

setLinkSlide(slideIndex)

Ustawia wartość Link dla podanego parametru Slide przy użyciu indeksu opartego na zerze.

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

Parametry

NazwaTypOpis
slideIndexIntegerIndeks zależny od zera.

Zwróć

LinkLink, który został ustawiony

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

setLinkSlide(slide)

Ustawia wartość Link dla podanego elementu 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.

Zwróć

LinkLink, który został ustawiony

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

setLinkSlide(slidePosition)

Ustawia atrybut Link na określoną wartość Slide przy użyciu względnej pozycji slajdu.

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

Parametry

NazwaTypOpis
slidePositionSlidePositionWzględny SlidePosition.

Zwróć

LinkLink, który został ustawiony

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

setLinkUrl(url)

Ustawia wartość Link dla danego niepustego ciągu adresu URL.

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

Parametry

NazwaTypOpis
urlStringCiąg adresu URL.

Zwróć

LinkLink, który został ustawiony

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 w prawo o stopnie.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Parametry

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

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

setTitle(title)

Ustawia tytuł alternatywny tekstu 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 tekstowy, do którego ma zostać ustawiony tytuł alternatywny.

Zwróć

Shape – ten element strony,

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

setTop(top)

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

Parametry

NazwaTypOpis
topNumberNowa pionowa pozycja do ustawienia w punktach.

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu 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 z użyciem tego przekształcenia.

Aktualizacja przekształcenia grupy powoduje zmianę bezwzględnej liczby elementów strony w tej grupie, które mogą zmieniać wygląd.

Aktualizowanie przekształcenia elementu strony, który jest w grupie, zmienia tylko przekształcenie tego elementu strony. Nie ma wpływu na przekształcenie grupy ani innych elementów strony.

Aby dowiedzieć się więcej o tym, jak przekształcenia wpływają na wygląd elementów zamówienia, przeczytaj artykuł getTransform().

Parametry

NazwaTypOpis
transformAffineTransformTransformacja ustawiona dla tego elementu strony.

Zwróć

Shape – ten element na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

setWidth(width)

Określa szerokość elementu w punktach, czyli szerokość ramki ograniczającej elementu, gdy element nie ma obrotu.

Ta metoda jest niezgodna ze wszystkimi elementami strony. Aby dowiedzieć się, które elementy strony są niezgodne z tą metodą, sprawdź ograniczenia rozmiaru i pozycji.

Parametry

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

Zwróć

Shape – ten element strony na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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