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
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 element strony nie ma żadnych witryn połączenia. |
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 podlega obrocie. |
getInherentHeight() | Number | Zwraca nieodłączną wysokość elementu podaną w punktach. |
getInherentWidth() | Number | Zwraca nieodłączną szerokość elementu w punktach. |
getLeft() | Number | Zwraca pozycję elementu w poziomie w punktach, mierzoną od lewego górnego rogu strony, gdy element nie jest obracany. |
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 należy do grupy. |
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 obiektem zastępczym. |
getRotation() | Number | Zwraca kąt obrotu elementu w prawo wokół jego środka, przy czym 0 stopni oznacza brak obrotu. |
getShapeType() | ShapeType | Zwraca typ kształtu. |
getText() | TextRange | Zwraca zawartość tekstową kształtu. |
getTitle() | String | Zwraca tytuł tekstu alternatywnego elementu strony. |
getTop() | Number | Pobiera w punktach pozycję pionową elementu zmierzoną od lewego górnego rogu strony, gdy element nie jest obracany. |
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 zaznaczenia. |
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 podlega obrocie. |
setLeft(left) | Shape | Określa pozycję elementu w poziomie w punktach, mierzoną od lewego górnego rogu strony, gdy element nie jest obracany. |
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 pionową pozycję elementu w punktach, zmierzoną od lewego górnego rogu strony, gdy element nie jest obracany. |
setTransform(transform) | Shape | Ustawia przekształcenie elementu strony za pomocą podanego przekształcenia. |
setWidth(width) | Shape | Ustawia szerokość elementu w punktach, 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 należy wyrównać ten element strony na stronie. |
Powroty
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.
Powroty
Shape
– ten element strony służący 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 służący 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 umieszczany na tej samej stronie i w tym samym położeniu co oryginał.
Powroty
PageElement
– nowy duplikat tego 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 wartość Autofit
tekstu w obrębie tego kształtu. Jeśli kształt nie pozwala na tekst, to null
.
Powroty
Autofit
– automatyczne dopasowanie tekstu w danym kształcie.
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()
getConnectionSites()
Zwraca listę elementów ConnectionSite
w elemencie strony lub pustą listę, jeśli element strony nie ma żadnych witryn połączenia.
Powroty
ConnectionSite[]
– lista witryn połączeń, która może być pusta, jeśli ten element nie ma stron połączenia.
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 wartość ContentAlignment
tekstu 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 tekstowy elementu strony. Opis jest połączony z tytułem, który wyświetla i odczytuje tekst alternatywny.
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()
getHeight()
Pobiera wysokość elementu w punktach, która jest wysokością ramki ograniczającej elementu, gdy element nie podlega obrocie.
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 pozycji.
Powroty
Number
– maksymalna wysokość elementu strony podana 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 nieodłączną wysokość elementu podaną w punktach.
Przekształcenie elementu strony zależy od jego rozmiaru. Aby określić ostateczny wygląd elementu, użyj rozmiaru wewnętrznego w połączeniu z przekształceniem elementu.
Powroty
Number
– maksymalna wysokość elementu strony podana 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 rozmiaru. Aby określić ostateczny wygląd elementu, użyj rozmiaru wewnętrznego w połączeniu z przekształceniem elementu.
Powroty
Number
– maksymalna szerokość elementu strony podana 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 jest obracany.
Powroty
Number
– położenie tego elementu w poziomie w punktach w lewym górnym 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
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()); }
Powroty
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 obiektu. Identyfikatory obiektów używane przez strony i ich elementy mają taką 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 reprezentowany jako 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 dla obiektu zastępczego. Zwraca null
, jeśli kształt nie jest obiektem zastępczym lub nie ma elementu nadrzędnego.
Powroty
PageElement
– nadrzędny element strony tego obiektu zastępczego kształtu lub element null
, jeśli ten 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 dwa wystąpienia tego samego typu zmiennej, każdy z nich ma własną, unikalną wartość indeksu. Zwraca wartość null
, jeśli kształt nie jest obiektem zastępczym.
Powroty
Integer
– indeks obiektu zastępczego tego kształtu lub wartość null
, jeśli kształt nie jest obiektem 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 obiektu zastępczego kształtu lub wartość PlaceholderType.NONE
, jeśli kształt nie jest obiektem zastępczym.
Powroty
PlaceholderType
– typ obiektu zastępczego 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, przy czym 0 stopni oznacza brak obrotu.
Powroty
Number
– kąt obrotu w stopniach od 0 (włącznie) do 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()
getText()
Zwraca zawartość tekstową kształtu.
Tekst w kształcie 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 połą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 w punktach pozycję pionową elementu zmierzoną od lewego górnego rogu strony, gdy element nie jest obracany.
Powroty
Number
– położenie tego elementu w pionie w punktach w lewym górnym 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 przekształcenia bezwzględnego. 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, 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 są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycji.
Powroty
Number
– maksymalna szerokość elementu strony podana 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 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. |
Powroty
Shape
– ten element strony służący 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 żadnego, sama grupa również zostanie usunięta.
Jeśli obiekt zastępczy PageElement
zostanie usunięty z elementu głównego lub układu, wszystkie puste dziedziczone zmienne również 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
removeLink()
Usuwa element Link
.
shape.removeLink();
replaceWithImage(blobSource)
Zastępuje ten kształt obrazem dostarczonym przez BlobSource
.
Obraz jest pobierany z podanego BlobSource
raz w momencie wstawiania, a jego kopia jest zapisywana w celu wyświetlenia w prezentacji. Rozmiar obrazu nie może przekraczać 50 MB,
i nie może przekraczać 25 megapikseli i musi być w formacie PNG, JPEG lub GIF.
Aby zachować współczynnik proporcji obrazu, obraz jest skalowany 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
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Dane obrazu. |
Powroty
Image
– element Image
, 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 jego pobranie z BlobSource
, a kopia jest przechowywana do wyświetlania w prezentacji. Obrazy muszą być w rozmiarze mniejszym niż 50 MB,
nie mogą przekraczać 25 megapikseli i 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
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 zostanie przeskalowany i wyśrodkowany. |
Powroty
Image
– element Image
, 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 jego pobranie z adresu URL tylko raz, a kopia jest zapisywana do wyświetlenia w prezentacji. Rozmiar obrazu nie może przekraczać 50 MB, nie może przekraczać 25 megapikseli i musi 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 adres URL jest zapisywany razem z obrazem i udostępniany przez Image.getSourceUrl()
.
Aby zachować współczynnik proporcji obrazu, obraz jest skalowany i wyśrodkowany względem rozmiaru istniejącego kształtu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL obrazu, z którego można go pobrać. |
Powroty
Image
– element Image
, 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 jego pobranie z adresu URL tylko raz, a kopia jest zapisywana do wyświetlenia w prezentacji. Rozmiar obrazu nie może przekraczać 50 MB, nie może przekraczać 25 megapikseli i musi być w formacie PNG, JPEG lub GIF.
Podany adres URL nie może być większy niż 2 kB. Sam adres URL jest zapisywany razem z obrazem i udostępniany w ramach funkcji 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 zostanie przeskalowany i wyśrodkowany. |
Powroty
Image
– element Image
, 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 Arkuszy Google, który można zaktualizować. 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
Nazwa | Typ | Opis |
---|---|---|
sourceChart | EmbeddedChart | Wykres 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 z Arkuszy Google.
Aby zachować współczynnik proporcji wykresu z Arkuszy Google, obraz na wykresie jest skalowany i 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. |
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 według określonego współczynnika. Wysokość elementu to wysokość jego ramki ograniczającej, gdy element nie podlega obrocie.
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 pozycji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
ratio | Number | Współczynnik skalowania wysokości tego elementu strony. |
Powroty
Shape
– ten element strony służący 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 według określonego współczynnika. Szerokość elementu to szerokość jego ramki ograniczającej, gdy element nie ma rotacji.
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 pozycji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
ratio | Number | Współczynnik skalowania szerokości tego elementu strony. |
Powroty
Shape
– ten element strony służący 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()
Wybiera tylko element PageElement
w aktywnej prezentacji i usuwa wszystkie poprzednie zaznaczenia. Ta funkcja działa tak samo, jak nawiązanie połączenia z numerem select(replace)
w aplikacji true
.
Skrypt ma dostęp tylko do wyboru użytkownika, który go uruchamia, 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();
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)
Wybiera element PageElement
w aktywnej prezentacji.
Skrypt ma dostęp tylko do wyboru użytkownika, który go uruchamia, i tylko wtedy, gdy skrypt jest powiązany z prezentacją.
Przekaż true
do tej metody, aby wybrać tylko PageElement
i usunąć wcześniejszy wybór. Spowoduje to również ustawienie nadrzędnego Page
obiektu PageElement
na current page selection
.
Aby wybrać kilka obiektów PageElement
, miń false
. Obiekty PageElement
muszą być w tym samym obiekcie Page
.
Podczas wybierania elementu strony za pomocą parametru false
muszą być spełnione te warunki:
- Elementem nadrzędnym
Page
obiektuPageElement
musi byćcurrent page selection
. - Nie można zaznaczyć wielu obiektów
Page
.
Aby mieć pewność, że tak jest, najlepiej jest wybrać najpierw element nadrzędny Page
za pomocą elementu Page.selectAsCurrentPage()
, a następnie elementy tej strony.
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 wartość true , zastąpi dowolny poprzedni wybór. W przeciwnym razie zaznaczenie zostanie dodane do poprzedniego zaznaczenia. |
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 służący 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()
Przesuwa element strony na tylną część strony.
Element strony nie może należeć do grupy.
Powroty
Shape
– ten element strony służący 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 wyłącza właściwości automatycznego dopasowania tekstu w zaktualizowanych kształtach.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentAlignment | ContentAlignment | Wyrównanie do ustawienia. |
Powroty
Shape
– kształt do ł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
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 tekstowy, dla którego ma zostać ustawiony tekst alternatywny opisu. |
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, która jest wysokością ramki ograniczającej elementu, gdy element nie podlega obrocie.
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 pozycji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
height | Number | Nowa wysokość tego elementu strony do ustawienia (w punktach). |
Powroty
Shape
– ten element strony służący 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)
Określa pozycję elementu w poziomie w punktach, mierzoną od lewego górnego rogu strony, gdy element nie jest obracany.
Parametry
Nazwa | Typ | Opis |
---|---|---|
left | Number | Nowa pozycja w poziomie do ustawienia (w punktach). |
Powroty
Shape
– ten element strony służący 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 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. |
Powroty
Link
– Link
, który został ustawiony;
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 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. |
Powroty
Link
– Link
, który został ustawiony;
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 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 . |
Powroty
Link
– Link
, który został ustawiony;
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 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. |
Powroty
Link
– Link
, który został ustawiony;
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 w prawo dookoła jego środka (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 pozycji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
angle | Number | Nowy kąt obrotu w prawo do ustawienia w stopniach. |
Powroty
Shape
– ten element strony służący 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
Nazwa | Typ | Opis |
---|---|---|
title | String | Ciąg, dla którego należy ustawić 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)
Określa pionową pozycję elementu w punktach, zmierzoną od lewego górnego rogu strony, gdy element nie jest obracany.
Parametry
Nazwa | Typ | Opis |
---|---|---|
top | Number | Nowa pozycja w pionie do ustawienia (w punktach). |
Powroty
Shape
– ten element strony służący 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 za pomocą podanego przekształcenia.
Aktualizacja przekształcenia grupy zmienia transformację bezwzględną elementów strony w tej grupie, co może zmienić ich wygląd.
Aktualizacja przekształcenia elementu strony, który jest w grupie, zmienia tylko przekształcenie tego elementu strony i nie ma wpływu na przekształcenia grupy ani innych elementów strony, które należą do grupy.
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. |
Powroty
Shape
– ten element służy 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, 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 są niezgodne z tą metodą, zapoznaj się z ograniczeniami dotyczącymi rozmiaru i pozycji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
width | Number | Nowa szerokość tego elementu strony do ustawienia (w punktach). |
Powroty
Shape
– ten element strony służący 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