Class PositionedImage

KonumlandırılmışResim

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ö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ürme.
getBlob()BlobBu nesnenin içindeki verileri bir blob olarak döndürme.
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 enum değeri alır.
getLeftOffset()NumberResmin paragrafın solundan olan ofsetini (noktalar cinsinden) alır.
getParagraph()ParagraphResmin sabitlendiği Paragraph öğesini alır.
getTopOffset()NumberResmin paragrafın üst kısmından olan ofsetini (noktalar cinsinden) alır.
getWidth()IntegerResmin piksel cinsinden genişliğini alır.
setHeight(height)PositionedImageResmin piksel cinsinden yüksekliğini ayarlar.
setLayout(layout)PositionedImageResmin nasıl yerleştirileceğinin tanımını belirler.
setLeftOffset(offset)PositionedImageResmin paragrafın solundan olan ofsetini (noktalar cinsinden) ayarlar.
setTopOffset(offset)PositionedImageResmin paragrafın üst kısmına olan ofsetini (noktalar cinsinden) ayarlar.
setWidth(width)PositionedImageResmin 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

AdTürAçıklama
contentTypeStringDö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ümanı için 'text/markdown' de geçerlidir.

Return

Blob: Veriler bir blob olarak.


getBlob()

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

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ı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 yerleştirildiğ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

AdTürAçıklama
heightIntegerResmin 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

AdTürAçıklama
layoutPositionedLayoutDü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

AdTürAçıklama
offsetNumberparagrafı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

AdTürAçıklama
offsetNumberparagrafı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

AdTürAçıklama
widthIntegerResmin 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