Paragraph
'ye sabitlenmiş sabit konumlu resim. InlineImage
'ten farklı olarak PositionedImage
bir Element
değildir. Üst öğesi veya kardeşi Element
yoktur. Bunun yerine, bir Paragraph
veya ListItem
'a sabitlenir ve bu sabit noktadan ofsetler aracılığıyla yerleştirilir. PositionedImage
'lerin referans vermek için kullanılabilecek bir kimliği vardır.
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);
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getAs(contentType) | Blob | Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürme. |
getBlob() | Blob | Bu nesnenin içindeki verileri bir blob olarak döndürme. |
getHeight() | Integer | Resmin piksel cinsinden yüksekliğini alır. |
getId() | String | Resmin kimliğini alır. |
getLayout() | PositionedLayout | Resmin nasıl yerleştirildiğini temsil eden bir enum değeri alır. |
getLeftOffset() | Number | Resmin paragrafın solundan olan ofsetini (noktalar cinsinden) alır. |
getParagraph() | Paragraph | Resmin sabitlendiği Paragraph öğesini alır. |
getTopOffset() | Number | Resmin paragrafın üst kısmından olan ofsetini (noktalar cinsinden) alır. |
getWidth() | Integer | Resmin piksel cinsinden genişliğini alır. |
setHeight(height) | PositionedImage | Resmin piksel cinsinden yüksekliğini ayarlar. |
setLayout(layout) | PositionedImage | Resmin nasıl yerleştirileceğinin tanımını belirler. |
setLeftOffset(offset) | PositionedImage | Resmin paragrafın solundan olan ofsetini (noktalar cinsinden) ayarlar. |
setTopOffset(offset) | PositionedImage | Resmin paragrafın üst kısmına olan ofsetini (noktalar cinsinden) ayarlar. |
setWidth(width) | PositionedImage | Resmin piksel cinsinden genişliğini ayarlar. |
Ayrıntılı dokümanlar
getAs(contentType)
Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürme. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktayı (varsa) izleyen kısmının, değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "AlışverişListesi.25.12.2014", "AlışverişListesi.25.12.pdf" olur.
Dönüşümler için günlük kotaları görüntülemek istiyorsanız Google Hizmetleri için kotalar başlıklı makaleyi inceleyin. Yeni oluşturulan Google Workspace alanları geçici olarak daha katı kotalara tabi olabilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
contentType | String | Dönüştürülecek MIME türü. Çoğu blob için 'application/pdf' tek geçerli seçenektir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp' , 'image/gif' , 'image/jpeg' veya 'image/png' değerlerinden herhangi biri de geçerlidir. Google Dokümanlar dokümanları için 'text/markdown' de geçerlidir. |
Return
Blob
: Veriler bir blob olarak.
getBlob()
getHeight()
Resmin piksel cinsinden yüksekliğini alır.
Return
Integer
: Resmin piksel cinsinden yüksekliği
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getId()
Resmin kimliğini alır.
Return
String
: resim kimliği
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLayout()
Resmin nasıl düzenlendiğini temsil eden bir enum değeri alır.
Return
PositionedLayout
: Resim düzeni
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLeftOffset()
Resmin paragrafın solundan olan ofsetini (noktalar cinsinden) alır.
Return
Number
: Resmin sol paragrafın solundan itibaren ofseti
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParagraph()
Resmin sabitlendiği Paragraph
öğesini alır.
Return
Paragraph
: Üst paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTopOffset()
Resmin paragrafın üst kısmından olan ofsetini (noktalar cinsinden) alır.
Return
Number
: Resmin sol paragrafın üst kısmına göre ofseti
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getWidth()
Resmin piksel cinsinden genişliğini alır.
Return
Integer
: Resmin piksel cinsinden genişliği
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setHeight(height)
Resmin piksel cinsinden yüksekliğini ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
height | Integer | Resmin piksel cinsinden yüksekliği |
Return
PositionedImage
: Geçerli nesne
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLayout(layout)
Resmin nasıl yerleştirileceğinin tanımını belirler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
layout | PositionedLayout | Düzen modunu temsil eden bir enum |
Return
PositionedImage
: zincirleme için bu nesne
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLeftOffset(offset)
Resmin paragrafın solundan olan ofsetini (noktalar cinsinden) ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
offset | Number | paragrafın solundan itibaren offset |
Return
PositionedImage
: zincirleme için bu nesne
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTopOffset(offset)
Resmin paragrafın üst kısmına olan ofsetini (noktalar cinsinden) ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
offset | Number | paragrafın üst kısmından ofset |
Return
PositionedImage
: zincirleme için bu nesne
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setWidth(width)
Resmin piksel cinsinden genişliğini ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
width | Integer | Resmin piksel cinsinden genişliği |
Return
PositionedImage
: Geçerli nesne
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents