Halaman ini diterjemahkan oleh Cloud Translation API.

Class PositionedImage

Gambar posisi tetap yang ditambatkan ke Paragraph. Tidak seperti InlineImage, PositionedImage bersifat bukan Element. Fitur ini tidak memiliki orang tua atau saudara kandung, Element. Sebagai gantinya, titik 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().getActiveTab().asDocumentTab().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 merepresentasikan tata letak gambar.
`getLeftOffset()`	`Number`	Mendapatkan offset gambar, dalam titik, dari bagian 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`	Menyetel offset gambar, dalam titik, dari bagian kiri paragraf.
`setTopOffset(offset)`	`PositionedImage`	Menyetel 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. 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()`

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 merepresentasikan penataan 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 titik, dari bagian kiri paragraf.

Pulang pergi

Number — offset gambar dari bagian 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 titik, 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

Nama	Jenis	Deskripsi
`height`	`Integer`	tinggi gambar, dalam {i>pixel<i}

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 cara penataan gambar.

Parameter

Nama	Jenis	Deskripsi
`layout`	`PositionedLayout`	enum yang mewakili mode tata letak

Pulang pergi

PositionedImage — objek untuk perantaian 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

`setLeftOffset(offset)`

Menyetel offset gambar, dalam titik, dari bagian kiri paragraf.

Parameter

Nama	Jenis	Deskripsi
`offset`	`Number`	offset dari bagian kiri paragraf

Pulang pergi

PositionedImage — objek untuk perantaian 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

`setTopOffset(offset)`

Menyetel offset gambar, dalam titik, dari bagian atas paragraf.

Parameter

Nama	Jenis	Deskripsi
`offset`	`Number`	offset dari bagian atas paragraf

Pulang pergi

PositionedImage — objek untuk perantaian 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

`setWidth(width)`

Menetapkan lebar gambar, dalam piksel.

Parameter

Nama	Jenis	Deskripsi
`width`	`Integer`	lebar 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