Memperbaiki gambar posisi yang ditambatkan ke Paragraph
. Tidak seperti InlineImage
, PositionedImage
bukan Element
. Class ini tidak memiliki
Element
induk atau saudara kandung. Sebaliknya,
elemen ini ditambatkan ke Paragraph
atau ListItem
, dan ditempatkan melalui offset dari
anchor tersebut. PositionedImage
memiliki ID yang dapat digunakan untuk mereferensikannya.
var body = DocumentApp.getActiveDocument().getBody(); // Append a new paragraph. var paragraph = body.appendParagraph("New paragraph to anchor the image to."); // Get an image in Drive from its ID. var image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob(); // Add the PositionedImage with offsets (in points). var posImage = paragraph.addPositionedImage(image) .setTopOffset(60) .setLeftOffset(40);
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
getAs(contentType) | Blob | Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. |
getBlob() | Blob | Menampilkan data di dalam objek ini sebagai blob. |
getHeight() | Integer | Mengambil tinggi gambar, dalam piksel. |
getId() | String | Mendapatkan ID gambar. |
getLayout() | PositionedLayout | Mendapatkan nilai enum yang mewakili cara gambar ditata. |
getLeftOffset() | Number | Mendapatkan offset gambar, dalam titik, dari sebelah kiri paragraf. |
getParagraph() | Paragraph | Mendapatkan Paragraph tempat gambar ditambatkan. |
getTopOffset() | Number | Mendapatkan offset gambar, dalam titik, dari bagian atas paragraf. |
getWidth() | Integer | Mengambil lebar gambar, dalam piksel. |
setHeight(height) | PositionedImage | Menetapkan tinggi gambar, dalam piksel. |
setLayout(layout) | PositionedImage | Menetapkan definisi cara penataan gambar. |
setLeftOffset(offset) | PositionedImage | Menetapkan offset gambar, dalam titik, dari kiri paragraf. |
setTopOffset(offset) | PositionedImage | Menetapkan offset gambar, dalam titik, dari bagian atas paragraf. |
setWidth(width) | PositionedImage | Menetapkan 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, dianggap bahwa bagian nama file yang mengikuti titik terakhir (jika ada) adalah ekstensi yang sudah 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 untuk sementara mungkin dikenai kuota yang lebih ketat.
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, 'image/bmp' , 'image/gif' , 'image/jpeg' , atau 'image/png' juga
valid. |
Return
Blob
— Data sebagai blob.
getBlob()
getHeight()
Mengambil tinggi gambar, dalam piksel.
Return
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.
Return
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 mewakili cara gambar ditata.
Return
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 titik, dari sebelah kiri paragraf.
Return
Number
— offset gambar dari sisi kiri paragraf
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()
getTopOffset()
Mendapatkan offset gambar, dalam titik, dari bagian atas paragraf.
Return
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.
Return
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
Nama | Jenis | Deskripsi |
---|---|---|
height | Integer | tinggi gambar, dalam piksel |
Return
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 cara penataan gambar.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
layout | PositionedLayout | enum yang mewakili mode tata letak |
Return
PositionedImage
— objek ini untuk perantaian
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 titik, dari kiri paragraf.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
offset | Number | offset dari sisi kiri paragraf |
Return
PositionedImage
— objek ini untuk perantaian
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 titik, dari bagian atas paragraf.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
offset | Number | offset dari bagian atas paragraf |
Return
PositionedImage
— objek ini untuk perantaian
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
Nama | Jenis | Deskripsi |
---|---|---|
width | Integer | lebar gambar, dalam piksel |
Return
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