Paragraph
için sabit konumlu resim. InlineImage
öğesinin aksine PositionedImage
, Element
değildir. Üst veya kardeş Element
öğesi yok. Bunun yerine, bir Paragraph
veya ListItem
için sabitlenir ve bu bağlayıcıdan gelen ofsetler aracılığıyla yerleştirilir. PositionedImage
, kendisine referans vermek için kullanılabilecek bir kimliğe sahiptir.
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);
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ürün. |
getBlob() | Blob | Bu nesnenin içindeki verileri blob olarak döndürün. |
getHeight() | Integer | Resmin yüksekliğini piksel cinsinden alır. |
getId() | String | Resmin kimliğini alır. |
getLayout() | PositionedLayout | Resmin düzenini temsil eden bir enum değeri alır. |
getLeftOffset() | Number | Resmin belirli uzaklıkta kopyasını, punto cinsinden paragrafın solundan gelecek şekilde alır. |
getParagraph() | Paragraph | Resmin bağlı olduğu Paragraph öğesini getirir. |
getTopOffset() | Number | Resmin belirli uzaklıkta kopyasını, punto cinsinden paragrafın üst kısmından alır. |
getWidth() | Integer | Resmin genişliğini piksel cinsinden alır. |
setHeight(height) | PositionedImage | Resmin yüksekliğini piksel cinsinden ayarlar. |
setLayout(layout) | PositionedImage | Resmin nasıl düzenlendiğinin tanımını belirler. |
setLeftOffset(offset) | PositionedImage | Resmin ofsetini paragrafın solundan itibaren punto cinsinden ayarlar. |
setTopOffset(offset) | PositionedImage | Resmin ofsetini paragrafın üstünden nokta olarak ayarlar. |
setWidth(width) | PositionedImage | Resmin genişliğini piksel cinsinden ayarlar. |
Ayrıntılı belgeler
getAs(contentType)
Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün. Bu yöntem, dosya adına uygun uzantıyı ekler (örneğin, "dosyam.pdf"). Bununla birlikte, dosya adında son noktanın ardından gelen bölümün (varsa) değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "ShoppingList.12.25.2014", "ShoppingList.12.25.pdf" haline gelir.
Günlük dönüşüm kotalarını görüntülemek için Google Hizmetleri Kotalar bölümüne bakın. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkı kotalara tabi olabilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
contentType | String | Dönüştürülecek MIME türü. Çoğu blob için geçerli tek seçenek 'application/pdf' 'tir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp' , 'image/gif' , 'image/jpeg' veya 'image/png' değerleri de geçerlidir. |
Return
Blob
: Blob halinde veriler.
getBlob()
getHeight()
Resmin yüksekliğini piksel cinsinden alır.
Return
Integer
— resmin piksel cinsinden yüksekliği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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ı, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLayout()
Resmin düzenini temsil eden bir enum değeri alır.
Return
PositionedLayout
— resim düzeni
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLeftOffset()
Resmin belirli uzaklıkta kopyasını, punto cinsinden paragrafın solundan gelecek şekilde alır.
Return
Number
— resmin sol paragrafın solundan belirli uzaklıktaki kopyası
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParagraph()
Resmin bağlı olduğu Paragraph
öğesini getirir.
Return
Paragraph
- üst paragraf
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTopOffset()
Resmin belirli uzaklıkta kopyasını, punto cinsinden paragrafın üst kısmından alır.
Return
Number
— resmin sol paragrafın üstünden uzaklığı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getWidth()
Resmin genişliğini piksel cinsinden alır.
Return
Integer
— resmin piksel cinsinden genişliği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setHeight(height)
Resmin yüksekliğini piksel cinsinden 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ı, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLayout(layout)
Resmin nasıl düzenlendiğinin tanımını belirler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
layout | PositionedLayout | düzen modunu temsil eden bir numaralandırma |
Return
PositionedImage
— zincirleme bağlantı için bu nesne
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLeftOffset(offset)
Resmin ofsetini paragrafın solundan itibaren punto cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
offset | Number | paragrafın solundan belirli uzaklıkta |
Return
PositionedImage
— zincirleme bağlantı için bu nesne
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTopOffset(offset)
Resmin ofsetini paragrafın üstünden nokta olarak ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
offset | Number | paragrafın üstünden belirli uzaklıkta |
Return
PositionedImage
— zincirleme bağlantı için bu nesne
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setWidth(width)
Resmin genişliğini piksel cinsinden 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ı, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents