Class Shape

Bentuk

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
alignOnPage(alignmentPosition)ShapeMeratakan elemen ke posisi perataan yang ditentukan di halaman.
bringForward()ShapeMembawa elemen halaman ke depan di halaman sebanyak satu elemen.
bringToFront()ShapeMembawa elemen halaman ke bagian depan halaman.
duplicate()PageElementMenduplikasi elemen halaman.
getAutofit()AutofitMenampilkan Autofit teks dalam bentuk ini.
getBorder()BorderMenampilkan Border bentuk.
getConnectionSites()ConnectionSite[]Menampilkan daftar ConnectionSite di elemen halaman, atau daftar kosong jika elemen halaman tidak memiliki situs koneksi.
getContentAlignment()ContentAlignmentMenampilkan ContentAlignment teks dalam bentuk.
getDescription()StringMenampilkan deskripsi teks alternatif elemen halaman.
getFill()FillMenampilkan Fill bentuk.
getHeight()NumberMendapatkan tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.
getInherentHeight()NumberMenampilkan tinggi yang melekat pada elemen dalam titik.
getInherentWidth()NumberMenampilkan lebar yang melekat pada elemen dalam titik.
getLeft()NumberMenampilkan posisi horizontal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
getLink()LinkMenampilkan Link atau null jika tidak ada link.
getObjectId()StringMenampilkan ID unik untuk objek ini.
getPageElementType()PageElementTypeMenampilkan jenis elemen halaman, yang direpresentasikan sebagai enum PageElementType.
getParentGroup()GroupMenampilkan grup tempat elemen halaman ini berada, atau null jika elemen tidak berada dalam grup.
getParentPage()PageMenampilkan halaman tempat elemen halaman ini berada.
getParentPlaceholder()PageElementMenampilkan elemen halaman induk dari placeholder.
getPlaceholderIndex()IntegerMenampilkan indeks placeholder bentuk.
getPlaceholderType()PlaceholderTypeMenampilkan jenis placeholder bentuk, atau PlaceholderType.NONE jika bentuk tersebut bukan placeholder.
getRotation()NumberMenampilkan sudut rotasi elemen searah jarum jam di sekitar pusatnya dalam derajat, dengan nol derajat berarti tidak ada rotasi.
getShapeType()ShapeTypeMenampilkan jenis bentuk.
getText()TextRangeMenampilkan konten teks bentuk.
getTitle()StringMenampilkan judul teks alternatif elemen halaman.
getTop()NumberMendapatkan posisi vertikal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
getTransform()AffineTransformMenampilkan transformasi elemen halaman.
getWidth()NumberMenampilkan lebar elemen dalam titik, yang merupakan lebar kotak pembatas elemen jika elemen tidak memiliki rotasi.
preconcatenateTransform(transform)ShapeMenggabungkan transformasi yang disediakan ke transformasi elemen halaman yang ada.
remove()voidMenghapus elemen halaman.
removeLink()voidMenghapus Link.
replaceWithImage(blobSource)ImageMengganti bentuk ini dengan gambar yang disediakan oleh BlobSource.
replaceWithImage(blobSource, crop)ImageMengganti bentuk ini dengan gambar yang disediakan oleh BlobSource.
replaceWithImage(imageUrl)ImageMengganti bentuk ini dengan gambar.
replaceWithImage(imageUrl, crop)ImageMengganti bentuk ini dengan gambar.
replaceWithSheetsChart(sourceChart)SheetsChartMenggantikan bentuk ini dengan bagan Google Sheets.
replaceWithSheetsChartAsImage(sourceChart)ImageMengganti bentuk ini dengan gambar diagram Google Spreadsheet.
scaleHeight(ratio)ShapeMenskalakan tinggi elemen dengan rasio yang ditentukan.
scaleWidth(ratio)ShapeMenskalakan lebar elemen dengan rasio yang ditentukan.
select()voidHanya memilih PageElement di presentasi aktif dan menghapus pilihan sebelumnya.
select(replace)voidMemilih PageElement di presentasi aktif.
sendBackward()ShapeMengirim elemen halaman mundur di halaman sebesar satu elemen.
sendToBack()ShapeMengirim elemen halaman ke bagian belakang halaman.
setContentAlignment(contentAlignment)ShapeMenetapkan ContentAlignment teks dalam bentuk.
setDescription(description)ShapeMenetapkan deskripsi teks alternatif elemen halaman.
setHeight(height)ShapeMenetapkan tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.
setLeft(left)ShapeMenetapkan posisi horizontal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
setLinkSlide(slideIndex)LinkMenetapkan Link ke Slide yang ditentukan menggunakan indeks slide yang berbasis nol.
setLinkSlide(slide)LinkMenetapkan Link ke Slide yang ditentukan, link ditetapkan oleh ID slide yang diberikan.
setLinkSlide(slidePosition)LinkMenetapkan Link ke Slide yang ditentukan menggunakan posisi relatif slide.
setLinkUrl(url)LinkMenetapkan Link ke string URL yang tidak kosong.
setRotation(angle)ShapeMenetapkan sudut rotasi elemen searah jarum jam di sekitar pusatnya dalam derajat.
setTitle(title)ShapeMenetapkan judul teks alternatif elemen halaman.
setTop(top)ShapeMenetapkan posisi vertikal elemen dalam titik, yang diukur dari sudut kiri atas halaman jika elemen tidak memiliki rotasi.
setTransform(transform)ShapeMenetapkan transformasi elemen halaman dengan transformasi yang disediakan.
setWidth(width)ShapeMenetapkan 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

NamaJenisDeskripsi
alignmentPositionAlignmentPositionPosisi 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()

Menampilkan Border bentuk.

Return

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

Menampilkan Fill bentuk.

Return

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

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

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.

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

Menampilkan jenis bentuk.

Return

ShapeType — Jenis bentuk ini.


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

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

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

NamaJenisDeskripsi
blobSourceBlobSourceData gambar.

Return

ImageImage 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

NamaJenisDeskripsi
blobSourceBlobSourceData gambar.
cropBooleanJika true, pangkas gambar agar sesuai dengan ukuran bentuk yang ada. Jika tidak, gambar akan diskalakan dan dipusatkan.

Return

ImageImage 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

NamaJenisDeskripsi
imageUrlStringURL gambar untuk mendownload gambar.

Return

ImageImage 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

NamaJenisDeskripsi
imageUrlStringURL gambar untuk mendownload gambar.
cropBooleanJika true, pangkas gambar agar sesuai dengan ukuran bentuk yang ada. Jika tidak, gambar akan diskalakan dan dipusatkan.

Return

ImageImage 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

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

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

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

NamaJenisDeskripsi
ratioNumberRasio 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:

  1. Page induk dari objek PageElement harus berupa current page selection.
  2. 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

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

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

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

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

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

NamaJenisDeskripsi
slideIndexIntegerIndeks berbasis nol ke slide.

Return

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

NamaJenisDeskripsi
slideSlideSlide yang akan ditautkan.

Return

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

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

NamaJenisDeskripsi
slidePositionSlidePositionSlidePosition relatif.

Return

LinkLink 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

NamaJenisDeskripsi
urlStringString URL.

Return

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

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

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

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

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

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