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 względem określonej pozycji na stronie. |
bringForward() | Shape | Powoduje przesuwanie elementu na stronie do przodu o 1 element. |
bringToFront() | Shape | Przenosi element strony na początek strony. |
duplicate() | PageElement | Duplikuje element strony. |
getAutofit() | Autofit | Zwraca Autofit tekstu w tym kształcie. |
getBorder() | Border | Zwraca 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 ContentAlignment tekstu w kształcie. |
getDescription() | String | Zwraca tekst alternatywny tekstu elementu strony. |
getFill() | Fill | Zwraca Fill kształtu. |
getHeight() | Number | Pobiera wysokość punktów w punktach, czyli wysokość ramki ograniczającej elementu, gdy element nie ma obrotu. |
getInherentHeight() | Number | Zwraca unikalną wysokość elementu w punktach. |
getInherentWidth() | Number | Zwraca wewnętrzną szerokość elementu w punktach. |
getLeft() | Number | Zwraca poziomą pozycję elementu w punktach mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu. |
getLink() | Link | Zwraca wartość Link lub null , jeśli nie ma linku. |
getObjectId() | String | Zwraca unikalny identyfikator tego obiektu. |
getPageElementType() | PageElementType | Zwraca typ elementu strony wyrażony w postaci wyliczenia PageElementType . |
getParentGroup() | Group | Zwraca grupę, do której należy ten element strony, lub wartość null , jeśli elementu nie ma w grupie. |
getParentPage() | Page | Zwraca stronę, na której znajduje się ten element strony. |
getParentPlaceholder() | PageElement | Zwraca element nadrzędny strony zastępczej. |
getPlaceholderIndex() | Integer | Zwraca indeks zastępczy kształtu. |
getPlaceholderType() | PlaceholderType | Zwraca typ obiektu zastępczego kształtu lub PlaceholderType.NONE , jeśli kształt nie jest symbolem zastępczym. |
getRotation() | Number | Zwraca kąt obrotu w prawo o stopnie (w stopniach), przy czym zero 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 pionie pozycję elementu mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu. |
getTransform() | AffineTransform | Zwraca przekształcenie elementu strony. |
getWidth() | Number | Zwraca 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() | void | Usuwa element strony. |
removeLink() | void | Usuwa Link . |
replaceWithImage(blobSource) | Image | Zastępuje ten kształt obrazem pochodzącym z usługi BlobSource . |
replaceWithImage(blobSource, crop) | Image | Zastępuje ten kształt obrazem pochodzącym z usługi 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 o określony współczynnik. |
scaleWidth(ratio) | Shape | Skaluje szerokość elementu o określony współczynnik. |
select() | void | Wybiera tylko PageElement w aktywnej prezentacji i usuwa poprzednie zaznaczenie. |
select(replace) | void | Zaznacza element PageElement w aktywnej prezentacji. |
sendBackward() | Shape | Wysyła jeden element na stronie wstecz. |
sendToBack() | Shape | Wysyła element strony z tyłu strony. |
setContentAlignment(contentAlignment) | Shape | Ustawia ContentAlignment tekstu w kształcie. |
setDescription(description) | Shape | Ustawia tekst alternatywny elementu strony. |
setHeight(height) | Shape | Ustawia wysokość elementu w punktach, czyli wysokość ramki ograniczającej elementu, gdy element nie jest obrócony. |
setLeft(left) | Shape | Ustawia poziomą pozycję elementu w punktach mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu. |
setLinkSlide(slideIndex) | Link | Ustawia wartość Link dla podanego parametru Slide przy użyciu indeksu opartego na zerze. |
setLinkSlide(slide) | Link | Ustawia wartość Link dla podanego elementu Slide . Link jest ustawiany przez podany identyfikator slajdu. |
setLinkSlide(slidePosition) | Link | Ustawia atrybut Link na określoną wartość Slide przy użyciu względnej pozycji slajdu. |
setLinkUrl(url) | Link | Ustawia wartość Link dla danego niepustego ciągu adresu URL. |
setRotation(angle) | Shape | Ustawia kąt obrotu elementu w prawo o stopnie. |
setTitle(title) | Shape | Ustawia tytuł alternatywny tekstu elementu strony. |
setTop(top) | Shape | Określa w pionie pozycję elementu mierzoną od lewego górnego rogu strony, gdy element nie ma obrotu. |
setTransform(transform) | Shape | Ustawia przekształcenie elementu strony z użyciem tego przekształcenia. |
setWidth(width) | Shape | Okreś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
Nazwa | Typ | Opis |
---|---|---|
alignmentPosition | AlignmentPosition | Pozycja 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()
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()
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
getLink()
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óć
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()
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
Nazwa | Typ | Opis |
---|---|---|
transform | AffineTransform | Przekształ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
removeLink()
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
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Dane obrazu. |
Zwróć
Image
– Image
, 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
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Dane obrazu. |
crop | Boolean | Jeśli true ma przycięcie, obraz jest dopasowany do rozmiaru istniejącego kształtu. W przeciwnym razie obraz jest skalowany i wyśrodkowany. |
Zwróć
Image
– Image
, 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
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL obrazu, z którego można go pobrać. |
Zwróć
Image
– Image
, 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
Nazwa | Typ | Opis |
---|---|---|
imageUrl | String | Adres URL obrazu, z którego można go pobrać. |
crop | Boolean | Jeśli true ma przycięcie, obraz jest dopasowany do rozmiaru istniejącego kształtu. W przeciwnym razie obraz jest skalowany i wyśrodkowany. |
Zwróć
Image
– Image
, 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
Nazwa | Typ | Opis |
---|---|---|
sourceChart | EmbeddedChart | Wykres 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
Nazwa | Typ | Opis |
---|---|---|
sourceChart | EmbeddedChart | Wykres 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
Nazwa | Typ | Opis |
---|---|---|
ratio | Number | Współ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
Nazwa | Typ | Opis |
---|---|---|
ratio | Number | Współ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:
- Nadrzędny
Page
obiektuPageElement
musi byćcurrent page selection
. - 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
Nazwa | Typ | Opis |
---|---|---|
replace | Boolean | Jeś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
Nazwa | Typ | Opis |
---|---|---|
contentAlignment | ContentAlignment | Wyró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
Nazwa | Typ | Opis |
---|---|---|
description | String | Cią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
Nazwa | Typ | Opis |
---|---|---|
height | Number | Nowa 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
Nazwa | Typ | Opis |
---|---|---|
left | Number | Nowa 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
Nazwa | Typ | Opis |
---|---|---|
slideIndex | Integer | Indeks zależny od zera. |
Zwróć
Link
– Link
, 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
Nazwa | Typ | Opis |
---|---|---|
slide | Slide | Slide do połączenia. |
Zwróć
Link
– Link
, 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
Nazwa | Typ | Opis |
---|---|---|
slidePosition | SlidePosition | Względny SlidePosition . |
Zwróć
Link
– Link
, 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
Nazwa | Typ | Opis |
---|---|---|
url | String | Ciąg adresu URL. |
Zwróć
Link
– Link
, 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
Nazwa | Typ | Opis |
---|---|---|
angle | Number | Nowy 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
Nazwa | Typ | Opis |
---|---|---|
title | String | Cią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
Nazwa | Typ | Opis |
---|---|---|
top | Number | Nowa 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
Nazwa | Typ | Opis |
---|---|---|
transform | AffineTransform | Transformacja 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
Nazwa | Typ | Opis |
---|---|---|
width | Number | Nowa 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