Class PositionedImage

PositionedImage

Paragraph öğesine sabitlenmiş, sabit konumlu resim. InlineImage'dan farklı olarak PositionedImage, Element değildir. Üst öğesi veya kardeş öğesi yoksa Element. Bunun yerine, Paragraph veya ListItem öğesine sabitlenir ve bu sabitleme noktasından uzaklıklar kullanılarak yerleştirilir. PositionedImage, referans vermek için kullanılabilecek bir kimliğe sahiptir. 

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ö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ür.
getBlob()BlobBu nesnenin içindeki verileri blob olarak döndürür.
getHeight()IntegerResmin piksel cinsinden yüksekliğini alır.
getId()StringResmin kimliğini alır.
getLayout()PositionedLayoutResmin nasıl yerleştirildiğini gösteren bir enum değeri alır.
getLeftOffset()NumberResmin paragrafın solundan olan ofsetini (nokta cinsinden) alır.
getParagraph()ParagraphResmin sabitlendiği Paragraph öğesini alır.
getTopOffset()NumberResmin paragrafın üst kısmından olan ofsetini (nokta cinsinden) 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ştirileceğinin tanımını ayarlar.
setLeftOffset(offset)PositionedImageResmin paragrafın solundan olan boşluğunu (nokta cinsinden) ayarlar.
setTopOffset(offset)PositionedImageResmin paragrafın üst kısmından olan ofsetini (puan cinsinden) ayarlar.
setWidth(width)PositionedImageResmin 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ür. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktadan sonraki kısmının (varsa) değiştirilmesi gereken mevcut bir uzantı olduğunu varsayar. Dolayısıyla, "ShoppingList.12.25.2014" ifadesi "ShoppingList.12.25.pdf" olur.

Dönüşümlerle ilgili günlük kotaları görüntülemek için Google Hizmetleri Kotaları başlıklı makaleyi inceleyin. Yeni oluşturulan Google Workspace alanları geçici olarak daha katı kotalara tabi olabilir.

Parametreler

AdTürAçıklama
contentTypeStringDönüştürülecek MIME türü. Çoğu blob için tek geçerli seçenek 'application/pdf''dır. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png' de geçerlidir. Google Dokümanlar dokümanlarında 'text/markdown' da geçerlidir.

Return

Blob — Veriler blob olarak.

getBlob()

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

Return

Blob — Veriler 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 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 kapsamlardan biri 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 gösteren bir enum değeri alır.

Return

PositionedLayout: Resim düzeni

Yetkilendirme

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

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

getLeftOffset()

Resmin paragrafın solundan olan ofsetini (nokta cinsinden) alır.

Return

Number: Resmin, sol paragrafın solundan olan uzaklığı

Yetkilendirme

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

  • 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getTopOffset()

Resmin paragrafın üst kısmından olan ofsetini (nokta cinsinden) alır.

Return

Number: Resmin, paragrafın sol üstünden ofseti

Yetkilendirme

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

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 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 yerleştirileceğinin tanımını ayarlar.

Parametreler

AdTürAçıklama
layoutPositionedLayoutDüzen modunu temsil eden bir enum

Return

PositionedImage: Zincirleme için bu nesne

Yetkilendirme

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

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

setLeftOffset(offset)

Resmin paragrafın solundan olan boşluğunu (nokta cinsinden) ayarlar.

Parametreler

AdTürAçıklama
offsetNumberparagrafın solundan itibaren boşluk

Return

PositionedImage: Zincirleme için bu nesne

Yetkilendirme

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

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

setTopOffset(offset)

Resmin paragrafın üst kısmından olan ofsetini (puan cinsinden) ayarlar.

Parametreler

AdTürAçıklama
offsetNumberparagrafın üst kısmından olan ofset

Return

PositionedImage: Zincirleme için bu nesne

Yetkilendirme

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

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 biri veya daha fazlasıyla yetkilendirme gerektirir:

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