Class PositionedImage

PositionedImage

Obraz o stałej pozycji zakotwiczony w elemencie Paragraph. W przeciwieństwie do InlineImage właściwość PositionedImage nie jest wartością Element. Nie ma elementu nadrzędnego ani równorzędnego Element. Zamiast tego jest zakotwiczony do elementu Paragraph lub ListItem i jest umieszczony w przesunięciach od tej kotwicy. Element PositionedImage ma identyfikator, który pozwala się do niego odwołać.

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

Metody

MetodaZwracany typKrótki opis
getAs(contentType)BlobZwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwracaj dane wewnątrz tego obiektu jako obiekt blob.
getHeight()IntegerPobiera wysokość obrazu w pikselach.
getId()StringPobiera identyfikator obrazu.
getLayout()PositionedLayoutPobiera wartość wyliczeniową, która reprezentuje sposób układu obrazu.
getLeftOffset()NumberPobiera odsunięcie obrazu w punktach od lewej strony akapitu.
getParagraph()ParagraphPobiera Paragraph, do którego obraz jest zakotwiczony.
getTopOffset()NumberPobiera odsunięcie obrazu w punktach od góry akapitu.
getWidth()IntegerPobiera szerokość obrazu w pikselach.
setHeight(height)PositionedImageUstawia wysokość obrazu w pikselach.
setLayout(layout)PositionedImageOkreśla definicję układu obrazu.
setLeftOffset(offset)PositionedImageOkreśla odsunięcie obrazu w punktach od lewej strony akapitu.
setTopOffset(offset)PositionedImageOkreśla odsunięcie obrazu w punktach od góry akapitu.
setWidth(width)PositionedImageUstawia szerokość obrazu w pikselach.

Szczegółowa dokumentacja

getAs(contentType)

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mójplik.pdf”. Zakładamy jednak, że część nazwy pliku, która występuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W związku z tym „Lista zakupów.12.25.2014” zmieni się na „Lista zakupów.12.25.pdf”.

Aby sprawdzić dzienne limity konwersji, przeczytaj artykuł Limity w usługach Google. Nowo utworzone domeny Google Workspace mogą tymczasowo podlegać bardziej rygorystycznym limitom.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma zostać przekonwertowany. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf'. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG obowiązują dowolne z tych wartości: 'image/bmp', 'image/gif', 'image/jpeg' i 'image/png'.

Powroty

Blob – dane w postaci obiektu blob.


getBlob()

Zwracaj dane wewnątrz tego obiektu jako obiekt blob.

Powroty

Blob – dane w postaci obiektu blob.


getHeight()

Pobiera wysokość obrazu w pikselach.

Powroty

Integer – wysokość obrazu w pikselach.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getId()

Pobiera identyfikator obrazu.

Powroty

String – identyfikator obrazu,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getLayout()

Pobiera wartość wyliczeniową, która reprezentuje sposób układu obrazu.

Powroty

PositionedLayout – układ obrazu,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getLeftOffset()

Pobiera odsunięcie obrazu w punktach od lewej strony akapitu.

Powroty

Number – przesunięcie obrazu od lewej krawędzi akapitu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getParagraph()

Pobiera Paragraph, do którego obraz jest zakotwiczony.

Powroty

Paragraph – akapit nadrzędny,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getTopOffset()

Pobiera odsunięcie obrazu w punktach od góry akapitu.

Powroty

Number – odsunięcie obrazu od górnej krawędzi lewego akapitu;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getWidth()

Pobiera szerokość obrazu w pikselach.

Powroty

Integer – szerokość obrazu w pikselach.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setHeight(height)

Ustawia wysokość obrazu w pikselach.

Parametry

NazwaTypOpis
heightIntegerwysokość obrazu w pikselach

Powroty

PositionedImage – bieżący obiekt,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setLayout(layout)

Określa definicję układu obrazu.

Parametry

NazwaTypOpis
layoutPositionedLayoutwyliczenie reprezentujące tryb układu

Powroty

PositionedImage – obiekt do tworzenia łańcuchów,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setLeftOffset(offset)

Określa odsunięcie obrazu w punktach od lewej strony akapitu.

Parametry

NazwaTypOpis
offsetNumberprzesunięcie od lewej krawędzi akapitu

Powroty

PositionedImage – obiekt do tworzenia łańcuchów,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setTopOffset(offset)

Określa odsunięcie obrazu w punktach od góry akapitu.

Parametry

NazwaTypOpis
offsetNumberprzesunięcie od góry akapitu

Powroty

PositionedImage – obiekt do tworzenia łańcuchów,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

setWidth(width)

Ustawia szerokość obrazu w pikselach.

Parametry

NazwaTypOpis
widthIntegerszerokość obrazu w pikselach

Powroty

PositionedImage – bieżący obiekt,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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