Class PositionedImage

PositionedImage

Paragraph öğesine sabitlenmiş sabit konumlu resim. InlineImage işlevinin aksine PositionedImage Element değil. Bir ebeveyn veya kardeş Element. Bunun yerine bir Paragraph veya ListItem'a sabitlenmiş durumdadır ve bahsedeceğim. PositionedImage, kendisine referans vermek için kullanılabilecek bir kimliğe sahiptir.

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);

Yöntemler

YöntemDönüş türüKısa açıklama
getAs(contentType)BlobBu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün.
getBlob()BlobBu nesnenin içindeki verileri blob olarak döndürün.
getHeight()IntegerResmin piksel cinsinden yüksekliğini alır.
getId()StringResmin kimliğini alır.
getLayout()PositionedLayoutResmin nasıl yerleştirildiğini temsil eden bir sıralama değeri alır.
getLeftOffset()NumberResmin uzaklığını paragrafın solundan nokta cinsinden alır.
getParagraph()ParagraphResmin bağlı olduğu Paragraph öğesini alır.
getTopOffset()NumberResmin ofsetini nokta cinsinden, paragrafın üst kısmından alır.
getWidth()IntegerResmin piksel cinsinden genişliğini alır.
setHeight(height)PositionedImageResmin yüksekliğini piksel cinsinden ayarlar.
setLayout(layout)PositionedImageResmin nasıl yerleştirildiğinin tanımını belirler.
setLeftOffset(offset)PositionedImageResmin uzaklığını paragrafın soluna göre, nokta cinsinden ayarlar.
setTopOffset(offset)PositionedImageResmin ofsetini nokta cinsinden paragrafın üstünden ayarlar.
setWidth(width)PositionedImageResmin piksel cinsinden genişliğini 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öntemi, dosya adına uygun uzantıyı ekler. Örneğin, "dosyam.pdf". Ancak, dosya adında son noktadan sonra gelen bölümün (varsa) mevcut bir alan olduğunu varsayar değiştirilmesi gereken uzantıdır. Sonuç olarak, "AlışverişListesi.12.25.2014" şu olur: "ShoppingList.12.25.pdf".

Günlük dönüşüm kotalarını görüntülemek için bkz. Google için Kotalar Hizmetler. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkılığa tabi olabilir kotalar.

Parametreler

AdTürAçıklama
contentTypeStringDönüşümün gerçekleştirileceği 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''ten herhangi biri de geçerlidir. Bir Google Dokümanlar dokümanı için 'text/markdown' ayrıca geçerlidir.

Return

Blob — Veriler bir blob olarak.


getBlob()

Bu nesnenin içindeki verileri blob olarak döndürün.

Return

Blob — Veriler bir blob olarak.


getHeight()

Resmin piksel cinsinden yüksekliğini alır.

Return

Integer — resmin piksel cinsinden yüksekliği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getLayout()

Resmin nasıl yerleştirildiğini temsil eden bir sıralama değeri alır.

Return

PositionedLayout — resim düzeni

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getLeftOffset()

Resmin uzaklığını paragrafın solundan nokta cinsinden alır.

Return

Number — sol paragrafın solundan uzaklık resmi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 alır.

Return

Paragraph — üst paragraf

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getTopOffset()

Resmin ofsetini nokta cinsinden, paragrafın üst kısmından alır.

Return

Number — resmin sol paragrafın üst kısmından uzaklığı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ı, aşağıdaki kapsamlardan bir 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

AdTürAçıklama
heightIntegerresmin piksel cinsinden yüksekliği

Return

PositionedImage — geçerli nesne

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setLayout(layout)

Resmin nasıl yerleştirildiğinin tanımını belirler.

Parametreler

AdTürAçıklama
layoutPositionedLayoutdüzen modunu temsil eden bir sıralama

Return

PositionedImage — zincirleme için bu nesne

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setLeftOffset(offset)

Resmin uzaklığını paragrafın soluna göre, nokta cinsinden ayarlar.

Parametreler

AdTürAçıklama
offsetNumberparagrafın solundan uzaklığı

Return

PositionedImage — zincirleme için bu nesne

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setTopOffset(offset)

Resmin ofsetini nokta cinsinden paragrafın üstünden ayarlar.

Parametreler

AdTürAçıklama
offsetNumberparagrafın üst kısmından uzaklaş

Return

PositionedImage — zincirleme için bu nesne

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setWidth(width)

Resmin piksel cinsinden genişliğini ayarlar.

Parametreler

AdTürAçıklama
widthIntegerresmin piksel cinsinden genişliği

Return

PositionedImage — geçerli nesne

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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