PageElement
yang merepresentasikan bentuk generik yang tidak memiliki klasifikasi yang
lebih spesifik. Termasuk kotak teks, persegi panjang, dan bentuk lain yang telah ditentukan sebelumnya.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
alignOnPage(alignmentPosition) | Shape | Meratakan elemen ke posisi perataan yang ditentukan di halaman. |
bringForward() | Shape | Membawa elemen halaman ke depan di halaman sebanyak satu elemen. |
bringToFront() | Shape | Membawa elemen halaman ke bagian depan halaman. |
duplicate() | PageElement | Menduplikasi elemen halaman. |
getAutofit() | Autofit | Menampilkan Autofit teks dalam bentuk ini. |
getBorder() | Border | Menampilkan Border bentuk. |
getConnectionSites() | ConnectionSite[] | Menampilkan daftar ConnectionSite di elemen halaman, atau daftar kosong jika elemen halaman tidak memiliki situs koneksi. |
getContentAlignment() | ContentAlignment | Menampilkan ContentAlignment teks dalam bentuk. |
getDescription() | String | Menampilkan deskripsi teks alternatif elemen halaman. |
getFill() | Fill | Menampilkan Fill bentuk. |
getHeight() | Number | Mendapatkan tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi. |
getInherentHeight() | Number | Menampilkan tinggi yang melekat pada elemen dalam titik. |
getInherentWidth() | Number | Menampilkan lebar yang melekat pada elemen dalam titik. |
getLeft() | Number | Menampilkan posisi horizontal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi. |
getLink() | Link | Menampilkan Link atau null jika tidak ada link. |
getObjectId() | String | Menampilkan ID unik untuk objek ini. |
getPageElementType() | PageElementType | Menampilkan jenis elemen halaman, yang direpresentasikan sebagai enum PageElementType . |
getParentGroup() | Group | Menampilkan grup tempat elemen halaman ini berada, atau null jika elemen tidak berada dalam grup. |
getParentPage() | Page | Menampilkan halaman tempat elemen halaman ini berada. |
getParentPlaceholder() | PageElement | Menampilkan elemen halaman induk dari placeholder. |
getPlaceholderIndex() | Integer | Menampilkan indeks placeholder bentuk. |
getPlaceholderType() | PlaceholderType | Menampilkan jenis placeholder bentuk, atau PlaceholderType.NONE jika bentuk tersebut bukan placeholder. |
getRotation() | Number | Menampilkan sudut rotasi elemen searah jarum jam di sekitar pusatnya dalam derajat, dengan nol derajat berarti tidak ada rotasi. |
getShapeType() | ShapeType | Menampilkan jenis bentuk. |
getText() | TextRange | Menampilkan konten teks bentuk. |
getTitle() | String | Menampilkan judul teks alternatif elemen halaman. |
getTop() | Number | Mendapatkan posisi vertikal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi. |
getTransform() | AffineTransform | Menampilkan transformasi elemen halaman. |
getWidth() | Number | Menampilkan lebar elemen dalam titik, yang merupakan lebar kotak pembatas elemen jika elemen tidak memiliki rotasi. |
preconcatenateTransform(transform) | Shape | Menggabungkan transformasi yang disediakan ke transformasi elemen halaman yang ada. |
remove() | void | Menghapus elemen halaman. |
removeLink() | void | Menghapus Link . |
replaceWithImage(blobSource) | Image | Mengganti bentuk ini dengan gambar yang disediakan oleh BlobSource . |
replaceWithImage(blobSource, crop) | Image | Mengganti bentuk ini dengan gambar yang disediakan oleh BlobSource . |
replaceWithImage(imageUrl) | Image | Mengganti bentuk ini dengan gambar. |
replaceWithImage(imageUrl, crop) | Image | Mengganti bentuk ini dengan gambar. |
replaceWithSheetsChart(sourceChart) | SheetsChart | Menggantikan bentuk ini dengan bagan Google Sheets. |
replaceWithSheetsChartAsImage(sourceChart) | Image | Mengganti bentuk ini dengan gambar diagram Google Spreadsheet. |
scaleHeight(ratio) | Shape | Menskalakan tinggi elemen dengan rasio yang ditentukan. |
scaleWidth(ratio) | Shape | Menskalakan lebar elemen dengan rasio yang ditentukan. |
select() | void | Hanya memilih PageElement di presentasi aktif dan menghapus pilihan
sebelumnya. |
select(replace) | void | Memilih PageElement di presentasi aktif. |
sendBackward() | Shape | Mengirim elemen halaman mundur di halaman sebesar satu elemen. |
sendToBack() | Shape | Mengirim elemen halaman ke bagian belakang halaman. |
setContentAlignment(contentAlignment) | Shape | Menetapkan ContentAlignment teks dalam bentuk. |
setDescription(description) | Shape | Menetapkan deskripsi teks alternatif elemen halaman. |
setHeight(height) | Shape | Menetapkan tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi. |
setLeft(left) | Shape | Menetapkan posisi horizontal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi. |
setLinkSlide(slideIndex) | Link | Menetapkan Link ke Slide yang ditentukan menggunakan indeks slide yang berbasis nol. |
setLinkSlide(slide) | Link | Menetapkan Link ke Slide yang ditentukan, link ditetapkan oleh ID slide yang diberikan. |
setLinkSlide(slidePosition) | Link | Menetapkan Link ke Slide yang ditentukan menggunakan posisi relatif slide. |
setLinkUrl(url) | Link | Menetapkan Link ke string URL yang tidak kosong. |
setRotation(angle) | Shape | Menetapkan sudut rotasi elemen searah jarum jam di sekitar pusatnya dalam derajat. |
setTitle(title) | Shape | Menetapkan judul teks alternatif elemen halaman. |
setTop(top) | Shape | Menetapkan posisi vertikal elemen dalam titik, yang diukur dari sudut kiri atas halaman jika elemen tidak memiliki rotasi. |
setTransform(transform) | Shape | Menetapkan transformasi elemen halaman dengan transformasi yang disediakan. |
setWidth(width) | Shape | Menetapkan lebar elemen dalam titik, yang merupakan lebar kotak pembatas elemen saat elemen tidak memiliki rotasi. |
Dokumentasi mendetail
alignOnPage(alignmentPosition)
Meratakan elemen ke posisi perataan yang ditentukan di halaman.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
alignmentPosition | AlignmentPosition | Posisi untuk menyejajarkan elemen halaman ini di halaman. |
Return
Shape
— Elemen halaman ini, untuk perantaian.
bringForward()
Membawa elemen halaman ke depan di halaman sebanyak satu elemen.
Elemen halaman tidak boleh berada dalam grup.
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
Membawa elemen halaman ke bagian depan halaman.
Elemen halaman tidak boleh berada dalam grup.
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
Menduplikasi elemen halaman.
Elemen halaman duplikat ditempatkan pada halaman yang sama pada posisi yang sama seperti halaman aslinya.
Return
PageElement
— Duplikat baru dari elemen halaman ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAutofit()
Menampilkan Autofit
teks dalam bentuk ini. Ini adalah null
jika bentuknya tidak mengizinkan teks.
Return
Autofit
— Penyesuaian otomatis teks dalam bentuk ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getBorder()
getConnectionSites()
Menampilkan daftar ConnectionSite
di elemen halaman, atau daftar kosong jika elemen halaman tidak memiliki situs koneksi.
Return
ConnectionSite[]
— Daftar situs koneksi, yang mungkin kosong jika elemen ini tidak memiliki situs koneksi.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getContentAlignment()
Menampilkan ContentAlignment
teks dalam bentuk.
Return
ContentAlignment
— Perataan teks dalam bentuk ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
Menampilkan deskripsi teks alternatif elemen halaman. Deskripsi digabungkan dengan judul untuk menampilkan dan membaca teks alternatif.
Return
String
— Deskripsi teks alternatif elemen halaman.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFill()
getHeight()
Mendapatkan tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.
Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.
Return
Number
— Tinggi inheren elemen halaman dalam poin, atau null
jika elemen halaman tidak
memiliki tinggi.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentHeight()
Menampilkan tinggi yang melekat pada elemen dalam titik.
Transformasi elemen halaman bersifat relatif terhadap ukuran yang melekat padanya. Gunakan ukuran yang melekat bersama transformasi elemen untuk menentukan tampilan visual akhir elemen.
Return
Number
— Tinggi inheren elemen halaman dalam poin, atau null
jika elemen halaman tidak
memiliki tinggi.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
Menampilkan lebar yang melekat pada elemen dalam titik.
Transformasi elemen halaman bersifat relatif terhadap ukuran yang melekat padanya. Gunakan ukuran yang melekat bersama transformasi elemen untuk menentukan tampilan visual akhir elemen.
Return
Number
— Lebar inheren elemen halaman dalam poin, atau null
jika elemen halaman tidak
memiliki lebar.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
Menampilkan posisi horizontal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
Return
Number
— Posisi horizontal elemen ini dalam titik, dari pojok kiri atas halaman.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLink()
Menampilkan Link
atau null
jika tidak ada link.
var link = shape.getLink(); if (link != null) { Logger.log('Shape has a link of type: ' + link.getLinkType()); }
Return
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getObjectId()
Menampilkan ID unik untuk objek ini. ID objek yang digunakan oleh halaman dan elemen halaman memiliki namespace yang sama.
Return
String
— ID unik untuk objek ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
Menampilkan jenis elemen halaman, yang direpresentasikan sebagai enum PageElementType
.
Return
PageElementType
— Jenis elemen halaman.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
Menampilkan grup tempat elemen halaman ini berada, atau null
jika elemen tidak berada dalam grup.
Return
Group
— Grup tempat elemen halaman ini berada, atau null
.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPage()
Menampilkan halaman tempat elemen halaman ini berada.
Return
Page
— Halaman tempat elemen ini berada.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPlaceholder()
Menampilkan elemen halaman induk dari placeholder. Menampilkan null
jika bentuk tersebut bukan placeholder atau tidak memiliki induk.
Return
PageElement
— Elemen halaman induk dari placeholder bentuk ini, atau null
jika bentuk ini bukan
placeholder atau tidak memiliki induk.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderIndex()
Menampilkan indeks placeholder bentuk. Jika ada dua atau beberapa instance dari jenis placeholder
yang sama di halaman yang sama, setiap instance memiliki nilai indeks uniknya sendiri. Menampilkan null
jika bentuknya bukan placeholder.
Return
Integer
— Indeks placeholder bentuk ini, atau null
jika bentuknya bukan placeholder.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderType()
Menampilkan jenis placeholder bentuk, atau PlaceholderType.NONE
jika bentuk tersebut bukan placeholder.
Return
PlaceholderType
— Jenis placeholder bentuk ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRotation()
Menampilkan sudut rotasi elemen searah jarum jam di sekitar pusatnya dalam derajat, dengan nol derajat berarti tidak ada rotasi.
Return
Number
— Sudut rotasi dalam derajat antara 0 (inklusif) dan 360 (eksklusif).
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapeType()
getText()
Menampilkan konten teks bentuk.
Teks dalam suatu bentuk selalu diakhiri dengan karakter baris baru.
Return
TextRange
— Konten teks dalam bentuk ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTitle()
Menampilkan judul teks alternatif elemen halaman. Judul digabungkan dengan deskripsi untuk menampilkan dan membaca teks alternatif.
Return
String
— Judul teks alternatif elemen halaman.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
Mendapatkan posisi vertikal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
Return
Number
— Posisi vertikal elemen ini dalam titik, dari pojok kiri atas halaman.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
Menampilkan transformasi elemen halaman.
Tampilan visual elemen halaman ditentukan oleh transformasi absolutnya. Untuk menghitung transformasi absolut, gabungkan transformasi elemen halaman dengan transformasi semua grup induknya. Jika elemen halaman tidak berada dalam grup, transformasi absolutnya akan sama dengan nilai di kolom ini.
Return
AffineTransform
— Transformasi elemen halaman.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
Menampilkan lebar elemen dalam titik, yang merupakan lebar kotak pembatas elemen jika elemen tidak memiliki rotasi.
Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.
Return
Number
— Lebar inheren elemen halaman dalam poin, atau null
jika elemen halaman tidak
memiliki lebar.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
Menggabungkan transformasi yang disediakan ke transformasi elemen halaman yang ada.
newTransform = argument * existingTransform
Misalnya, untuk memindahkan elemen halaman 36 poin ke kiri:
element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder() .setTranslateX(-36.0) .build());
Anda juga dapat mengganti transformasi elemen halaman dengan setTransform(transform)
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
transform | AffineTransform | Transformasi untuk digabungkan ke transformasi elemen halaman ini. |
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Menghapus elemen halaman.
Jika setelah operasi penghapusan, Group
hanya berisi satu atau tidak ada elemen halaman, grup itu sendiri juga akan dihapus.
Jika placeholder PageElement
dihapus pada master atau tata letak, semua placeholder turunan yang kosong juga akan dihapus.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
Menghapus Link
.
shape.removeLink();
replaceWithImage(blobSource)
Mengganti bentuk ini dengan gambar yang disediakan oleh BlobSource
.
Gambar diambil dari BlobSource
yang disediakan satu kali pada waktu penyisipan dan salinannya
disimpan untuk ditampilkan di dalam presentasi. Gambar harus berukuran kurang dari 50 MB, tidak boleh
melebihi 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.
Untuk mempertahankan rasio aspek gambar, gambar diskalakan dan dipusatkan sesuai ukuran bentuk yang ada.
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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
blobSource | BlobSource | Data gambar. |
Return
Image
— Image
yang mengganti bentuk.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithImage(blobSource, crop)
Mengganti bentuk ini dengan gambar yang disediakan oleh BlobSource
.
Jika gambar disisipkan, gambar akan diambil satu kali dari BlobSource
dan salinannya akan disimpan untuk
ditampilkan di dalam presentasi. Gambar harus berukuran kurang dari 50 MB, tidak boleh lebih dari 25
megapiksel, dan harus dalam format PNG, JPEG, atau 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
blobSource | BlobSource | Data gambar. |
crop | Boolean | Jika true , pangkas gambar agar sesuai dengan ukuran bentuk yang ada. Jika tidak, gambar akan diskalakan dan dipusatkan. |
Return
Image
— Image
yang mengganti bentuk.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithImage(imageUrl)
Mengganti bentuk ini dengan gambar.
Jika gambar disisipkan, gambar akan diambil satu kali dari URL dan salinannya akan disimpan untuk ditampilkan di dalam presentasi. Gambar harus berukuran kurang dari 50 MB, tidak boleh lebih dari 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.
URL yang diberikan harus dapat diakses oleh publik dan berukuran tidak boleh lebih dari 2 kB. URL itu sendiri disimpan
dengan gambar dan ditampilkan melalui Image.getSourceUrl()
.
Untuk mempertahankan rasio aspek gambar, gambar diskalakan dan dipusatkan sesuai ukuran bentuk yang ada.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
imageUrl | String | URL gambar untuk mendownload gambar. |
Return
Image
— Image
yang mengganti bentuk.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithImage(imageUrl, crop)
Mengganti bentuk ini dengan gambar.
Jika gambar disisipkan, gambar akan diambil satu kali dari URL dan salinannya akan disimpan untuk ditampilkan di dalam presentasi. Gambar harus berukuran kurang dari 50 MB, tidak boleh lebih dari 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.
URL yang diberikan tidak boleh lebih dari 2 kB. URL itu sendiri disimpan dengan gambar dan
ditampilkan melalui Image.getSourceUrl()
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
imageUrl | String | URL gambar untuk mendownload gambar. |
crop | Boolean | Jika true , pangkas gambar agar sesuai dengan ukuran bentuk yang ada. Jika tidak, gambar akan diskalakan dan dipusatkan. |
Return
Image
— Image
yang mengganti bentuk.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithSheetsChart(sourceChart)
Menggantikan bentuk ini dengan bagan Google Sheets.
Diagram tersebut ditautkan dengan diagram Google Spreadsheet sumber sehingga dapat diperbarui. Kolaborator lain dapat melihat link ke spreadsheet sumber.
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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
sourceChart | EmbeddedChart | Bagan dalam {i>spreadsheet<i} yang menggantikan bentuk. |
Return
SheetsChart
— Diagram yang mengganti bentuk.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithSheetsChartAsImage(sourceChart)
Mengganti bentuk ini dengan gambar diagram Google Spreadsheet.
Untuk mempertahankan rasio aspek diagram Google Spreadsheet, gambar diagram diskalakan dan dipusatkan sehubungan dengan ukuran bentuk yang ada.
Gambar diagram tidak ditautkan dengan diagram Google Spreadsheet sumber.
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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
sourceChart | EmbeddedChart | Bagan dalam {i>spreadsheet<i} yang menggantikan bentuk. |
Return
Image
— Gambar diagram yang mengganti bentuk.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
Menskalakan tinggi elemen dengan rasio yang ditentukan. Tinggi elemen adalah tinggi kotak pembatasnya saat elemen tidak memiliki rotasi.
Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
ratio | Number | Rasio untuk menskalakan tinggi elemen halaman ini. |
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
Menskalakan lebar elemen dengan rasio yang ditentukan. Lebar elemen adalah lebar kotak pembatasnya saat elemen tidak memiliki rotasi.
Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
ratio | Number | Rasio untuk menskalakan lebar elemen halaman ini. |
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Hanya memilih PageElement
di presentasi aktif dan menghapus pilihan
sebelumnya. Ini sama seperti memanggil select(replace)
dengan true
.
Skrip hanya dapat mengakses pemilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat ke presentasi.
Tindakan ini menetapkan Page
induk dari PageElement
sebagai 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();
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
Memilih PageElement
di presentasi aktif.
Skrip hanya dapat mengakses pemilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat ke presentasi.
Teruskan true
ke metode ini untuk hanya memilih PageElement
dan menghapus
pilihan sebelumnya. Tindakan ini juga menetapkan Page
induk dari PageElement
sebagai
current page selection
.
Teruskan false
untuk memilih beberapa objek PageElement
. Objek PageElement
harus berada dalam Page
yang sama.
Kondisi berikut harus dipenuhi saat memilih elemen halaman menggunakan parameter
false
:
Page
induk dari objekPageElement
harus berupacurrent page selection
.- Tidak boleh ada lebih dari satu objek
Page
yang dipilih.
Untuk memastikan demikian, pendekatan yang lebih disukai adalah memilih induk Page
terlebih dahulu menggunakan Page.selectAsCurrentPage()
, lalu pilih elemen halaman di halaman tersebut.
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); }
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
replace | Boolean | Jika true , pilihan akan menggantikan setiap pilihan sebelumnya; jika tidak,
pilihan akan ditambahkan ke pilihan sebelumnya. |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
Mengirim elemen halaman mundur di halaman sebesar satu elemen.
Elemen halaman tidak boleh berada dalam grup.
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
Mengirim elemen halaman ke bagian belakang halaman.
Elemen halaman tidak boleh berada dalam grup.
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setContentAlignment(contentAlignment)
Menetapkan ContentAlignment
teks dalam bentuk.
Metode ini secara otomatis menonaktifkan properti paskan otomatis teks pada bentuk yang diperbarui.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
contentAlignment | ContentAlignment | Perataan yang akan ditetapkan. |
Return
Shape
— Bentuk ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setDescription(description)
Menetapkan deskripsi teks alternatif elemen halaman.
Metode ini tidak didukung untuk elemen 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());
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
description | String | String untuk menetapkan deskripsi teks alternatif. |
Return
Shape
— Elemen halaman ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
Menetapkan tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.
Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
height | Number | Tinggi baru elemen halaman ini yang akan ditetapkan, dalam titik. |
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
Menetapkan posisi horizontal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
left | Number | Posisi horizontal baru yang akan ditetapkan, dalam titik. |
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
Menetapkan Link
ke Slide
yang ditentukan menggunakan indeks slide yang berbasis nol.
// Set a link to the first slide of the presentation. shape.setLinkSlide(0);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
slideIndex | Integer | Indeks berbasis nol ke slide. |
Return
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
Menetapkan Link
ke Slide
yang ditentukan, link ditetapkan oleh ID slide yang diberikan.
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; shape.setLinkSlide(slide);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
slide | Slide | Slide yang akan ditautkan. |
Return
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
Menetapkan Link
ke Slide
yang ditentukan menggunakan posisi relatif slide.
// Set a link to the first slide of the presentation. shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
slidePosition | SlidePosition | SlidePosition relatif. |
Return
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
Menetapkan Link
ke string URL yang tidak kosong.
// Set a link to the URL. shape.setLinkUrl("https://slides.google.com");
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
url | String | String URL. |
Return
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
Menetapkan sudut rotasi elemen searah jarum jam di sekitar pusatnya dalam derajat.
Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
angle | Number | Sudut rotasi baru searah jarum jam yang akan ditetapkan, dalam derajat. |
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTitle(title)
Menetapkan judul teks alternatif elemen halaman.
Metode ini tidak didukung untuk elemen 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());
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
title | String | String untuk menetapkan judul teks alternatif. |
Return
Shape
— Elemen halaman ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
Menetapkan posisi vertikal elemen dalam titik, yang diukur dari sudut kiri atas halaman jika elemen tidak memiliki rotasi.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
top | Number | Posisi vertikal baru yang akan ditetapkan, dalam titik. |
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
Menetapkan transformasi elemen halaman dengan transformasi yang disediakan.
Memperbarui transformasi grup akan mengubah transformasi absolut elemen halaman dalam grup tersebut, yang dapat mengubah tampilan visualnya.
Memperbarui transformasi elemen halaman yang ada di sebuah grup hanya akan mengubah transformasi elemen halaman tersebut. Perubahan ini tidak memengaruhi transformasi grup atau elemen halaman lainnya dalam grup tersebut.
Untuk mengetahui detail tentang pengaruh transformasi terhadap tampilan visual elemen halaman, lihat getTransform()
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
transform | AffineTransform | Transformasi yang ditetapkan untuk elemen halaman ini. |
Return
Shape
— Elemen ini, untuk membuat rantai.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
Menetapkan lebar elemen dalam titik, yang merupakan lebar kotak pembatas elemen saat elemen tidak memiliki rotasi.
Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
width | Number | Lebar baru elemen halaman ini yang akan ditetapkan, dalam titik. |
Return
Shape
— Elemen halaman ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations