Halaman ini diterjemahkan oleh Cloud Translation API.

Class Shape

PageElement yang merepresentasikan bentuk umum yang tidak memiliki klasifikasi yang lebih spesifik. Menyertakan kotak teks, persegi panjang, dan bentuk standar lainnya.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`alignOnPage(alignmentPosition)`	`Shape`	Menyejajarkan elemen dengan posisi perataan yang ditentukan pada halaman.
`bringForward()`	`Shape`	Majukan elemen halaman di halaman sebanyak satu elemen.
`bringToFront()`	`Shape`	Menampilkan elemen halaman di 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` pada 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 poin, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.
`getInherentHeight()`	`Number`	Menampilkan tinggi inheren elemen dalam titik.
`getInherentWidth()`	`Number`	Menampilkan lebar inheren 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 diwakili sebagai enum `PageElementType`.
`getParentGroup()`	`Group`	Menampilkan grup yang memiliki elemen halaman ini, atau `null` jika elemen tidak ada dalam grup.
`getParentPage()`	`Page`	Menampilkan halaman tempat elemen halaman ini aktif.
`getParentPlaceholder()`	`PageElement`	Menampilkan elemen halaman induk dari placeholder.
`getPlaceholderIndex()`	`Integer`	Menampilkan indeks placeholder bentuk.
`getPlaceholderType()`	`PlaceholderType`	Menampilkan jenis placeholder bentuk, atau `PlaceholderType.NONE` jika bentuknya bukan placeholder.
`getRotation()`	`Number`	Menampilkan sudut rotasi searah jarum jam pada 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 pojok 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 saat elemen tidak memiliki rotasi.
`preconcatenateTransform(transform)`	`Shape`	Mengonsolidasikan transformasi yang diberikan 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`	Mengganti bentuk ini dengan diagram Google Spreadsheet.
`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 berdasarkan rasio yang ditentukan.
`select()`	`void`	Hanya memilih `PageElement` di presentasi aktif dan menghapus pemilihan sebelumnya.
`select(replace)`	`void`	Memilih `PageElement` di presentasi aktif.
`sendBackward()`	`Shape`	Mengirimkan elemen halaman ke belakang pada 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, yaitu 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 berbasis nol dari slide.
`setLinkSlide(slide)`	`Link`	Menetapkan `Link` ke `Slide` yang ditentukan, link disetel oleh ID slide tertentu.
`setLinkSlide(slidePosition)`	`Link`	Menyetel `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 searah jarum jam pada elemen 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 saat 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)`

Menyejajarkan elemen dengan posisi perataan yang ditentukan pada halaman.

Parameter

Nama	Jenis	Deskripsi
`alignmentPosition`	`AlignmentPosition`	Posisi untuk menyelaraskan elemen halaman ini pada halaman.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

`bringForward()`

Majukan elemen halaman di halaman sebanyak satu elemen.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

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()`

Menampilkan elemen halaman di bagian depan halaman.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

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 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

`getAutofit()`

Menampilkan Autofit teks dalam bentuk ini. Ini adalah null jika bentuk tidak mengizinkan teks.

Pulang pergi

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()`

Menampilkan Border bentuk.

Pulang pergi

Border — Setelan batas 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

`getConnectionSites()`

Menampilkan daftar ConnectionSite pada elemen halaman, atau daftar kosong jika elemen 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

`getContentAlignment()`

Menampilkan ContentAlignment teks dalam bentuk.

Pulang pergi

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.

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

`getFill()`

Menampilkan Fill bentuk.

Pulang pergi

Fill — Setelan pengisian 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

`getHeight()`

Mendapatkan tinggi elemen dalam poin, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.

Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Pulang pergi

Number — Tinggi inheren elemen halaman dalam titik, 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 inheren elemen dalam titik.

Transformasi elemen halaman relatif terhadap ukuran yang melekat. Gunakan ukuran inheren seiring dengan transformasi elemen untuk menentukan tampilan visual akhir elemen.

Pulang pergi

Number — Tinggi inheren elemen halaman dalam titik, 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 inheren elemen dalam titik.

Transformasi elemen halaman relatif terhadap ukuran yang melekat. Gunakan ukuran inheren seiring dengan transformasi elemen untuk menentukan tampilan visual akhir elemen.

Pulang pergi

Number — Lebar 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.

Pulang pergi

Number — Posisi cakrawala 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

Link

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.

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 diwakili 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 yang memiliki elemen halaman ini, atau null jika elemen tidak ada dalam grup.

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 aktif.

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 dari placeholder. Menampilkan null jika bentuknya bukan placeholder atau tidak memiliki induk.

Pulang pergi

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 dua instance atau lebih dari jenis placeholder yang sama ada di halaman yang sama, masing-masing memiliki nilai indeks uniknya sendiri. Menampilkan null jika bentuknya bukan placeholder.

Pulang pergi

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 bentuknya bukan placeholder.

Pulang pergi

PlaceholderType — Jenis placeholder dari 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 searah jarum jam pada 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

`getShapeType()`

Menampilkan jenis bentuk.

Pulang pergi

ShapeType — Jenis bentuk ini.

`getText()`

Menampilkan konten teks bentuk.

Teks dalam bentuk selalu diakhiri dengan karakter baris baru.

Pulang pergi

TextRange — Konten teks 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.

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 dalam titik, yang diukur dari pojok kiri atas halaman saat elemen tidak memiliki rotasi.

Pulang pergi

Number — Posisi vertikal 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

`getTransform()`

Menampilkan transformasi elemen halaman.

Tampilan visual elemen halaman ditentukan oleh transformasi absolutnya. Untuk menghitung transformasi absolut, pra-gabungkan transformasi elemen halaman dengan transformasi semua grup induknya. Jika elemen halaman tidak ada dalam grup, transformasi absolutnya sama dengan nilai dalam kolom 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 saat elemen tidak memiliki rotasi.

Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Pulang pergi

Number — Lebar 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)`

Mengonsolidasikan transformasi yang diberikan 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 yang akan digabungkan dengan transformasi elemen halaman ini.

Pulang pergi

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 tanpa elemen halaman, grup tersebut juga akan dihapus.

Jika placeholder PageElement dihapus pada master atau tata letak, placeholder pewarisan 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 lebih dari 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.

Untuk mempertahankan rasio lebar tinggi gambar, gambar diskalakan dan dipusatkan sehubungan dengan 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.

Pulang pergi

Image — Image yang menggantikan 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.

Menyisipkan gambar akan mengambilnya dari BlobSource satu kali dan salinannya akan 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.

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.

Pulang pergi

Image — Image yang menggantikan 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.

Menyisipkan gambar akan mengambilnya dari URL sekali dan salinannya akan 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.

URL yang diberikan harus dapat diakses secara publik dan tidak lebih dari 2 kB. URL itu sendiri disimpan dengan gambar dan ditampilkan melalui Image.getSourceUrl().

Untuk mempertahankan rasio lebar tinggi gambar, gambar diskalakan dan dipusatkan sehubungan dengan ukuran bentuk yang ada.

Parameter

Nama	Jenis	Deskripsi
`imageUrl`	`String`	URL gambar tempat gambar didownload.

Pulang pergi

Image — Image yang menggantikan 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.

URL yang diberikan tidak boleh lebih dari 2 kB. URL itu sendiri disimpan dengan gambar dan diekspos melalui Image.getSourceUrl().

Parameter

Nama	Jenis	Deskripsi
`imageUrl`	`String`	URL gambar tempat gambar didownload.
`crop`	`Boolean`	Jika `true`, pangkas gambar agar sesuai dengan ukuran bentuk yang ada. Jika tidak, gambar akan diskalakan dan dipusatkan.

Pulang pergi

Image — Image yang menggantikan 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)`

Mengganti bentuk ini dengan diagram Google Spreadsheet.

Diagram ditautkan dengan diagram Google Spreadsheet sumber yang memungkinkannya untuk diperbarui. Kolaborator lainnya 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`	Diagram dalam spreadsheet yang menggantikan bentuk.

Pulang pergi

SheetsChart — Diagram yang menggantikan 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 lebar tinggi 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`	Diagram dalam spreadsheet yang menggantikan bentuk.

Pulang pergi

Image — Gambar diagram yang menggantikan 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 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

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 berdasarkan 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 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

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 pemilihan sebelumnya. Ini sama dengan memanggil select(replace) dengan true.

Skrip hanya dapat mengakses pilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat dengan presentasi.

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 memilih PageElement saja dan menghapus semua pilihan sebelumnya. Tindakan ini juga akan menetapkan Page induk dari PageElement sebagai current page selection.

Teruskan false untuk memilih beberapa objek PageElement. Objek PageElement harus ada di Page yang sama.

Kondisi berikut harus dipenuhi saat memilih elemen halaman menggunakan parameter false:

Page induk dari objek PageElement harus berupa current page selection.
Tidak boleh ada beberapa objek Page yang dipilih.

Untuk memastikan bahwa pendekatan yang diinginkan adalah memilih Page induk terlebih dahulu menggunakan Page.selectAsCurrentPage(), lalu memilih 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 tersebut akan menggantikan 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()`

Mengirimkan elemen halaman ke belakang pada halaman sebesar satu elemen.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

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.

Pulang pergi

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 otomatis menonaktifkan properti paskan otomatis teks pada bentuk yang telah diperbarui.

Parameter

Nama	Jenis	Deskripsi
`contentAlignment`	`ContentAlignment`	Perataan yang akan ditetapkan.

Pulang pergi

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.

Pulang pergi

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, yaitu tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.

Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Parameter

Nama	Jenis	Deskripsi
`height`	`Number`	Ketinggian baru elemen halaman ini yang akan ditetapkan, dalam poin.

Pulang pergi

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.

Pulang pergi

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 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 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 ditentukan, link disetel oleh ID slide tertentu.

// 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 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)`

Menyetel 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.

Pulang pergi

Link — Link yang 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.

// 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 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)`

Menetapkan sudut rotasi searah jarum jam pada elemen di sekitar pusatnya dalam derajat.

Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Parameter

Nama	Jenis	Deskripsi
`angle`	`Number`	Sudut rotasi searah jarum jam yang baru untuk disetel, dalam derajat.

Pulang pergi

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.

Pulang pergi

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 saat elemen tidak memiliki rotasi.

Parameter

Nama	Jenis	Deskripsi
`top`	`Number`	Posisi vertikal baru yang akan ditetapkan, dalam titik.

Pulang pergi

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 dalam grup hanya akan mengubah transformasi elemen halaman tersebut; perubahan tersebut tidak memengaruhi transformasi grup atau elemen halaman lainnya dalam grup.

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.

Pulang pergi

Shape — 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 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 yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Parameter

Nama	Jenis	Deskripsi
`width`	`Number`	Lebar baru elemen halaman yang akan ditetapkan, dalam titik.

Pulang pergi

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