PageElement
yang mewakili gambar.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
alignOnPage(alignmentPosition) | Image | Meratakan elemen ke posisi perataan yang ditentukan di halaman. |
bringForward() | Image | Meneruskan elemen halaman pada halaman dengan satu elemen. |
bringToFront() | Image | Membawa elemen halaman ke bagian depan halaman. |
duplicate() | PageElement | Menduplikasi elemen halaman. |
getAs(contentType) | Blob | Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. |
getBlob() | Blob | Menampilkan data di dalam gambar ini sebagai blob. |
getBorder() | Border | Menampilkan Border gambar. |
getConnectionSites() | ConnectionSite[] | Menampilkan daftar ConnectionSite pada elemen halaman, atau daftar kosong jika halaman
tidak memiliki situs koneksi. |
getContentUrl() | String | Mendapatkan URL ke gambar. |
getDescription() | String | Menampilkan deskripsi teks alternatif elemen halaman. |
getHeight() | Number | Mendapatkan tinggi elemen pada titik, yang merupakan tinggi kotak pembatas elemen saat tidak memiliki rotasi. |
getInherentHeight() | Number | Menampilkan tinggi inheren elemen dalam titik. |
getInherentWidth() | Number | Menampilkan lebar inheren elemen dalam titik. |
getLeft() | Number | Mengembalikan posisi horizontal elemen pada titik, yang diukur dari sudut kiri atas elemen 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 ada dalam
ras. |
getParentPage() | Page | Menampilkan halaman tempat elemen halaman ini berada. |
getParentPlaceholder() | PageElement | Menampilkan elemen halaman induk placeholder. |
getPlaceholderIndex() | Integer | Menampilkan indeks gambar placeholder. |
getPlaceholderType() | PlaceholderType | Menampilkan jenis placeholder gambar, atau PlaceholderType.NONE jika bentuk tidak
sebuah {i>placeholder<i}. |
getRotation() | Number | Menampilkan sudut rotasi searah jarum jam elemen di sekitar pusatnya dalam derajat, dengan nol derajat berarti tidak ada rotasi. |
getSourceUrl() | String | Mendapatkan URL sumber gambar, jika tersedia. |
getTitle() | String | Menampilkan judul teks alternatif elemen halaman. |
getTop() | Number | Mendapatkan posisi vertikal elemen pada titik, yang diukur dari sudut kiri atas halaman ketika 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) | Image | Melakukan prakoneksi transformasi yang disediakan ke transformasi elemen halaman yang ada. |
remove() | void | Menghapus elemen halaman. |
removeLink() | void | Menghapus Link . |
replace(blobSource) | Image | Mengganti gambar ini dengan gambar yang dijelaskan oleh objek BlobSource . |
replace(blobSource, crop) | Image | Mengganti gambar ini dengan gambar yang dijelaskan oleh objek Image , yang dapat dipangkas secara opsional
ukuran gambar. |
replace(imageUrl) | Image | Mengganti gambar ini dengan gambar lain yang didownload dari URL yang disediakan. |
replace(imageUrl, crop) | Image | Mengganti gambar ini dengan gambar lain yang didownload dari URL yang disediakan, atau dapat dipangkas secara opsional ukuran gambar. |
scaleHeight(ratio) | Image | Menskalakan tinggi elemen berdasarkan rasio yang ditentukan. |
scaleWidth(ratio) | Image | Menskalakan lebar elemen berdasarkan rasio yang ditentukan. |
select() | void | Hanya memilih PageElement di presentasi aktif dan menghapus yang sebelumnya
pilihan. |
select(replace) | void | Memilih PageElement di presentasi aktif. |
sendBackward() | Image | Mengirim elemen halaman mundur pada halaman sebesar satu elemen. |
sendToBack() | Image | Mengirim elemen halaman ke bagian belakang halaman. |
setDescription(description) | Image | Menetapkan deskripsi teks alternatif elemen halaman. |
setHeight(height) | Image | Menyetel tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat tidak memiliki rotasi. |
setLeft(left) | Image | Menetapkan posisi horizontal elemen dalam titik, yang diukur dari sudut kiri atas elemen halaman saat elemen tidak memiliki rotasi. |
setLinkSlide(slideIndex) | Link | Menetapkan Link ke Slide yang diberikan menggunakan indeks berbasis nol dari slide. |
setLinkSlide(slide) | Link | Menetapkan Link ke Slide yang diberikan, link ditetapkan oleh ID slide yang diberikan. |
setLinkSlide(slidePosition) | Link | Menetapkan Link ke Slide yang diberikan menggunakan posisi relatif slide. |
setLinkUrl(url) | Link | Menetapkan Link ke string URL yang tidak kosong yang diberikan. |
setRotation(angle) | Image | Menyetel sudut rotasi searah jarum jam di sekitar pusatnya dalam derajat. |
setTitle(title) | Image | Menetapkan judul teks alternatif elemen halaman. |
setTop(top) | Image | Menetapkan posisi vertikal elemen pada titik, yang diukur dari sudut kiri atas halaman ketika elemen tidak memiliki rotasi. |
setTransform(transform) | Image | Menetapkan transformasi elemen halaman dengan transformasi yang disediakan. |
setWidth(width) | Image | Menetapkan lebar elemen pada titik, yang merupakan lebar kotak pembatas elemen saat tidak memiliki rotasi. |
Dokumentasi mendetail
alignOnPage(alignmentPosition)
Meratakan elemen ke posisi perataan yang ditentukan di halaman.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
alignmentPosition | AlignmentPosition | Posisi untuk menyelaraskan elemen halaman ini di halaman. |
Pulang pergi
Image
— Elemen halaman ini, untuk perantaian.
bringForward()
Meneruskan elemen halaman pada halaman dengan satu elemen.
Elemen halaman tidak boleh berada dalam grup.
Pulang pergi
Image
— 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.
Pulang pergi
Image
— 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 dengan posisi yang sama dengan halaman aslinya.
Pulang pergi
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
getAs(contentType)
Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, mengasumsikan bahwa bagian dari nama {i>file<i} yang mengikuti titik terakhir (jika ada) adalah bagian yang harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".
Untuk melihat kuota harian untuk konversi, lihat Kuota untuk Google Layanan. Domain Google Workspace yang baru dibuat mungkin tunduk kepada aturan yang lebih ketat kuota tambahan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
contentType | String | Jenis MIME yang menjadi tujuan konversi. Untuk sebagian besar blob, 'application/pdf' adalah
satu-satunya opsi yang valid. Untuk gambar dalam format BMP, GIF, JPEG, atau PNG, dari 'image/bmp' , 'image/gif' , 'image/jpeg' , atau 'image/png' juga
valid. Untuk dokumen Google Dokumen, 'text/markdown' juga valid. |
Pulang pergi
Blob
— Data sebagai blob.
getBlob()
getBorder()
getConnectionSites()
Menampilkan daftar ConnectionSite
pada elemen halaman, atau daftar kosong jika halaman
tidak memiliki situs koneksi.
Pulang pergi
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
getContentUrl()
Mendapatkan URL ke gambar.
URL ini diberi tag dengan akun pemohon, sehingga siapa pun yang memiliki URL dapat mengakses gambar sebagai pemohon asli. Akses ke gambar mungkin hilang jika pengaturan berbagi presentasi berubah. Masa berlaku URL yang ditampilkan akan berakhir setelah beberapa saat.
Pulang pergi
String
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.
Pulang pergi
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
getHeight()
Mendapatkan tinggi elemen pada titik, yang merupakan tinggi kotak pembatas elemen saat 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.
Pulang pergi
Number
— Tinggi elemen halaman dalam titik, atau null
jika elemen halaman memiliki
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 inheren elemen dalam titik.
Transformasi elemen halaman relatif terhadap ukuran yang melekat. Gunakan ukuran yang melekat pada bersama dengan transformasi elemen untuk menentukan tampilan visual akhir elemen.
Pulang pergi
Number
— Tinggi elemen halaman dalam titik, atau null
jika elemen halaman memiliki
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 inheren elemen dalam titik.
Transformasi elemen halaman relatif terhadap ukuran yang melekat. Gunakan ukuran yang melekat pada bersama dengan transformasi elemen untuk menentukan tampilan visual akhir elemen.
Pulang pergi
Number
— Lebar yang melekat pada elemen halaman dalam poin, atau null
jika elemen halaman memiliki
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()
Mengembalikan posisi horizontal elemen pada titik, yang diukur dari sudut kiri atas elemen halaman saat elemen tidak memiliki rotasi.
Pulang pergi
Number
— Posisi horizontal elemen ini dalam titik, dari sudut 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()); }
Pulang pergi
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 berbagi namespace yang sama.
Pulang pergi
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
.
Pulang pergi
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 ada dalam
ras.
Pulang pergi
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.
Pulang pergi
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 placeholder. Menampilkan null
jika gambar bukan
placeholder atau tidak memiliki induk.
Pulang pergi
PageElement
— Elemen halaman induk placeholder gambar ini, atau null
jika gambar 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 gambar placeholder. Jika dua atau lebih gambar placeholder pada halaman yang sama
berjenis sama, mereka masing-masing
memiliki nilai indeks yang unik. Menampilkan null
jika gambar bukan
sebuah {i>placeholder<i}.
Pulang pergi
Integer
— Indeks placeholder gambar ini, atau null
jika gambar 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 gambar, atau PlaceholderType.NONE
jika bentuk tidak
sebuah {i>placeholder<i}.
Pulang pergi
PlaceholderType
— Jenis placeholder gambar 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 searah jarum jam elemen di sekitar pusatnya dalam derajat, dengan nol derajat berarti tidak ada rotasi.
Pulang pergi
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
getSourceUrl()
Mendapatkan URL sumber gambar, jika tersedia.
Jika gambar disisipkan dengan URL, menampilkan URL yang diberikan selama penyisipan gambar.
Pulang pergi
String
— URL gambar atau null
jika gambar tidak memiliki URL sumber.
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.
Pulang pergi
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 pada titik, yang diukur dari sudut kiri atas halaman ketika elemen tidak memiliki rotasi.
Pulang pergi
Number
— Posisi vertikal elemen ini di titik, dari sudut 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. Kepada menghitung transformasi absolut, menggabungkan transformasi elemen halaman dengan transformasi dari semua grup induknya. Jika elemen {i>page<i} tidak ada dalam grup, transformasi absolutnya adalah sama dengan nilai di {i>field<i} ini.
Pulang pergi
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.
Pulang pergi
Number
— Lebar yang melekat pada elemen halaman dalam poin, atau null
jika elemen halaman memiliki
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)
Melakukan prakoneksi 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 melakukan prakoneksi ke transformasi elemen halaman ini. |
Pulang pergi
Image
— 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 turunan kosong
{i>placeholder<i} 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();
replace(blobSource)
Mengganti gambar ini dengan gambar yang dijelaskan oleh objek BlobSource
.
Dengan menyisipkan gambar, Anda akan mengambilnya dari
BlobSource
sekali dan salinan akan disimpan untuk ditampilkan di dalam presentasi.
Gambar harus berukuran kurang dari 50 MB, tidak boleh lebih dari 25 megapiksel, dan harus dalam salah satu
Format PNG, JPEG, atau GIF.
Untuk mempertahankan rasio aspek gambar, gambar diskalakan dan dipusatkan dengan memperhatikan menjadi ukuran gambar yang ada.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); image.replace(driveImage);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
blobSource | BlobSource | Data gambar. |
Pulang pergi
Image
— Image
ini setelah penggantian.
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
replace(blobSource, crop)
Mengganti gambar ini dengan gambar yang dijelaskan oleh objek Image
, yang dapat dipangkas secara opsional
ukuran gambar.
Dengan menyisipkan gambar, Anda akan mengambilnya dari
BlobSource
sekali dan salinan akan disimpan untuk ditampilkan di dalam presentasi.
Gambar harus berukuran kurang dari 50 MB, tidak boleh lebih dari 25 megapiksel, dan harus dalam salah satu
Format PNG, JPEG, atau GIF.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); // Replace and crop the drive image. image.replace(driveImage, true);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
blobSource | BlobSource | Data gambar. |
crop | Boolean | Jika true , pangkas gambar agar sesuai dengan ukuran gambar yang ada. Jika tidak,
gambar diskalakan dan dipusatkan. |
Pulang pergi
Image
— Image
ini setelah penggantian.
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
replace(imageUrl)
Mengganti gambar ini dengan gambar lain yang didownload dari URL yang disediakan.
Menyisipkan gambar akan mengambilnya dari URL satu kali 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 secara publik dan berukuran maksimal 2 kB. URL itu sendiri disimpan
dengan gambar dan ditampilkan melalui getSourceUrl()
.
Untuk mempertahankan rasio aspek gambar, gambar diskalakan dan dipusatkan dengan memperhatikan menjadi ukuran gambar yang ada.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
imageUrl | String | URL asal download gambar. |
Pulang pergi
Image
— Image
ini setelah penggantian.
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
replace(imageUrl, crop)
Mengganti gambar ini dengan gambar lain yang didownload dari URL yang disediakan, atau dapat dipangkas secara opsional ukuran gambar.
Menyisipkan gambar akan mengambilnya dari URL satu kali 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 besar dari 2 kB.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
imageUrl | String | URL asal download gambar. |
crop | Boolean | Jika true , pangkas gambar agar sesuai dengan ukuran gambar yang ada. Jika tidak,
gambar diskalakan dan dipusatkan. |
Pulang pergi
Image
— Image
ini setelah penggantian.
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 berdasarkan rasio yang ditentukan. Tinggi elemen adalah tingginya kotak pembatas bila 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. |
Pulang pergi
Image
— 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 berdasarkan rasio yang ditentukan. Lebar elemen adalah lebar kotak pembatas bila 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. |
Pulang pergi
Image
— 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 yang sebelumnya
pilihan. Ini sama dengan memanggil select(replace)
dengan true
.
Skrip hanya dapat mengakses pilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat dengan presentasi.
Tindakan ini akan 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 pilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat dengan 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
. PageElement
objek harus berada dalam Page
yang sama.
Kondisi berikut harus dipenuhi saat memilih elemen halaman menggunakan false
:
Page
induk dari objekPageElement
harus berupacurrent page selection
.- Tidak boleh ada beberapa objek
Page
yang dipilih.
Untuk memastikan hal itu, pendekatan yang disarankan adalah memilih Page
induk
pertama-tama 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 ini akan menggantikan pilihan sebelumnya; jika tidak,
pilihan 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 pada halaman sebesar satu elemen.
Elemen halaman tidak boleh berada dalam grup.
Pulang pergi
Image
— 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.
Pulang pergi
Image
— 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
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. |
Pulang pergi
Image
— 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)
Menyetel tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat 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 poin. |
Pulang pergi
Image
— 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 elemen halaman saat elemen tidak memiliki rotasi.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
left | Number | Posisi horizontal baru yang akan ditetapkan, dalam poin. |
Pulang pergi
Image
— 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 diberikan menggunakan indeks berbasis nol dari slide.
// Set a link to the first slide of the presentation. shape.setLinkSlide(0);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
slideIndex | Integer | Indeks berbasis nol ke slide. |
Pulang pergi
Link
— Link
yang telah ditetapkan
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 diberikan, 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. |
Pulang pergi
Link
— Link
yang telah ditetapkan
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 diberikan 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. |
Pulang pergi
Link
— Link
yang telah ditetapkan
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 yang diberikan.
// Set a link to the URL. shape.setLinkUrl("https://slides.google.com");
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
url | String | String URL. |
Pulang pergi
Link
— Link
yang telah ditetapkan
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)
Menyetel sudut rotasi 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 searah jarum jam baru yang akan ditetapkan, dalam derajat. |
Pulang pergi
Image
— 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. |
Pulang pergi
Image
— 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 pada titik, yang diukur dari sudut kiri atas halaman ketika elemen tidak memiliki rotasi.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
top | Number | Posisi vertikal baru yang akan ditetapkan, dalam poin. |
Pulang pergi
Image
— 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 di kelompok tersebut, yang dapat mengubah tampilan visual mereka.
Memperbarui transformasi elemen halaman yang ada dalam suatu grup hanya akan mengubah transformasi elemen elemen halaman itu; perubahan ini tidak mempengaruhi transformasi grup atau elemen halaman lainnya di ras.
Untuk mengetahui detail tentang pengaruh transformasi terhadap tampilan visual elemen halaman, lihat getTransform()
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
transform | AffineTransform | Transformasi yang disetel untuk elemen halaman ini. |
Pulang pergi
Image
— Elemen 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
setWidth(width)
Menetapkan lebar elemen pada titik, yang merupakan lebar kotak pembatas elemen saat 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 poin. |
Pulang pergi
Image
— 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