Class PositionedImage

PositionedImage

Gambar posisi tetap yang ditempelkan ke Paragraph. Tidak seperti InlineImage, PositionedImage bukan Element. Tidak memiliki Element induk atau saudara kandung. Sebagai gantinya, objek ini ditambatkan ke Paragraph atau ListItem, dan ditempatkan melalui offset dari tambatan tersebut. PositionedImage memiliki ID yang dapat digunakan untuk mereferensikannya. 

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Append a new paragraph.
const paragraph = body.appendParagraph('New paragraph to anchor the image to.');

// Get an image in Drive from its ID.
const image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob();

// Add the PositionedImage with offsets (in points).
const posImage =
    paragraph.addPositionedImage(image).setTopOffset(60).setLeftOffset(40);

Metode

MetodeJenis nilai yang ditampilkanDeskripsi singkat
getAs(contentType)BlobMenampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan.
getBlob()BlobMenampilkan data di dalam objek ini sebagai blob.
getHeight()IntegerMengambil tinggi gambar, dalam piksel.
getId()StringMendapatkan ID gambar.
getLayout()PositionedLayoutMendapatkan nilai enum yang menunjukkan tata letak gambar.
getLeftOffset()NumberMendapatkan offset gambar, dalam poin, dari kiri paragraf.
getParagraph()ParagraphMendapatkan Paragraph tempat gambar ditambatkan.
getTopOffset()NumberMendapatkan offset gambar, dalam poin, dari bagian atas paragraf.
getWidth()IntegerMengambil lebar gambar, dalam piksel.
setHeight(height)PositionedImageMenetapkan tinggi gambar, dalam piksel.
setLayout(layout)PositionedImageMenetapkan definisi tata letak gambar.
setLeftOffset(offset)PositionedImageMenetapkan offset gambar, dalam poin, dari kiri paragraf.
setTopOffset(offset)PositionedImageMenetapkan offset gambar, dalam poin, dari bagian atas paragraf.
setWidth(width)PositionedImageMenetapkan lebar gambar, dalam piksel.

Dokumentasi mendetail

getAs(contentType)

Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Metode ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, fungsi ini mengasumsikan bahwa bagian nama file yang mengikuti titik terakhir (jika ada) adalah ekstensi yang ada dan harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".

Untuk melihat kuota harian konversi, lihat Kuota untuk Layanan Google. Domain Google Workspace yang baru dibuat mungkin tunduk pada kuota yang lebih ketat untuk sementara.

Parameter

NamaJenisDeskripsi
contentTypeStringJenis MIME yang akan dikonversi. Untuk sebagian besar blob, 'application/pdf' adalah satu-satunya opsi yang valid. Untuk gambar dalam format BMP, GIF, JPEG, atau PNG, salah satu 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()

Menampilkan data di dalam objek ini sebagai blob.

Pulang pergi

Blob — Data sebagai blob.

getHeight()

Mengambil tinggi gambar, dalam piksel.

Pulang pergi

Integer — tinggi gambar, dalam piksel

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getId()

Mendapatkan ID gambar.

Pulang pergi

String — ID gambar

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getLayout()

Mendapatkan nilai enum yang menunjukkan tata letak gambar.

Pulang pergi

PositionedLayout — tata letak gambar

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getLeftOffset()

Mendapatkan offset gambar, dalam poin, dari kiri paragraf.

Pulang pergi

Number — offset gambar dari kiri paragraf kiri

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getParagraph()

Mendapatkan Paragraph tempat gambar ditambatkan.

Pulang pergi

Paragraph — paragraf induk

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getTopOffset()

Mendapatkan offset gambar, dalam poin, dari bagian atas paragraf.

Pulang pergi

Number — offset gambar dari bagian atas paragraf kiri

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getWidth()

Mengambil lebar gambar, dalam piksel.

Pulang pergi

Integer — lebar gambar, dalam piksel

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setHeight(height)

Menetapkan tinggi gambar, dalam piksel.

Parameter

NamaJenisDeskripsi
heightIntegertinggi gambar, dalam piksel

Pulang pergi

PositionedImage — objek saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setLayout(layout)

Menetapkan definisi tata letak gambar.

Parameter

NamaJenisDeskripsi
layoutPositionedLayoutenum yang merepresentasikan mode tata letak

Pulang pergi

PositionedImage — objek ini untuk pengaitan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setLeftOffset(offset)

Menetapkan offset gambar, dalam poin, dari kiri paragraf.

Parameter

NamaJenisDeskripsi
offsetNumberoffset dari kiri paragraf

Pulang pergi

PositionedImage — objek ini untuk pengaitan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setTopOffset(offset)

Menetapkan offset gambar, dalam poin, dari bagian atas paragraf.

Parameter

NamaJenisDeskripsi
offsetNumberoffset dari bagian atas paragraf

Pulang pergi

PositionedImage — objek ini untuk pengaitan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setWidth(width)

Menetapkan lebar gambar, dalam piksel.

Parameter

NamaJenisDeskripsi
widthIntegerlebar gambar, dalam piksel

Pulang pergi

PositionedImage — objek saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents