Immagine con posizione fissa ancorata a Paragraph
. A differenza di InlineImage
, PositionedImage
non è
Element
. Non ha un
elemento principale o di pari livello Element
. Invece, è ancorato a un Paragraph
o ListItem
e viene posizionato tramite gli offset dall'ancoraggio. Un PositionedImage
ha un ID che può essere utilizzato come riferimento.
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);
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato. |
getBlob() | Blob | Restituisce i dati all'interno di questo oggetto sotto forma di blob. |
getHeight() | Integer | Recupera l'altezza dell'immagine in pixel. |
getId() | String | Consente di acquisire l'ID dell'immagine. |
getLayout() | PositionedLayout | Restituisce un valore enum che rappresenta il layout dell'immagine. |
getLeftOffset() | Number | Restituisce l'offset dell'immagine, in punti, dal bordo sinistro del paragrafo. |
getParagraph() | Paragraph | Recupera il Paragraph a cui è ancorata l'immagine. |
getTopOffset() | Number | Restituisce l'offset dell'immagine, in punti, dall'alto del paragrafo. |
getWidth() | Integer | Recupera la larghezza dell'immagine in pixel. |
setHeight(height) | PositionedImage | Imposta l'altezza dell'immagine in pixel. |
setLayout(layout) | PositionedImage | Imposta la definizione del layout dell'immagine. |
setLeftOffset(offset) | PositionedImage | Imposta l'offset dell'immagine, in punti, dal lato sinistro del paragrafo. |
setTopOffset(offset) | PositionedImage | Imposta l'offset dell'immagine, in punti, dal bordo superiore del paragrafo. |
setWidth(width) | PositionedImage | Imposta la larghezza dell'immagine in pixel. |
Documentazione dettagliata
getAs(contentType)
Restituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato. Questo metodo aggiunge l'estensione appropriata al nome del file, ad esempio "myfile.pdf". Tuttavia, si presuppone che la parte del nome del file che segue l'ultimo punto (se presente) sia un'estensione esistente che deve essere sostituita. Di conseguenza, "ShoppingList.12.25.2014" diventa "ShoppingList.12.25.pdf".
Per visualizzare le quote giornaliere per le conversioni, consulta Quote per i servizi Google. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a quote più severe.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
contentType | String | Il tipo MIME in cui eseguire la conversione. Per la maggior parte dei blob, 'application/pdf' è l'unica opzione valida. Per le immagini in formato BMP, GIF, JPEG o PNG, è valido anche qualsiasi formato 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png' . |
Ritorni
Blob
: i dati sotto forma di blob.
getBlob()
Restituisce i dati all'interno di questo oggetto sotto forma di blob.
Ritorni
Blob
: i dati sotto forma di blob.
getHeight()
Recupera l'altezza dell'immagine in pixel.
Ritorni
Integer
: l'altezza dell'immagine, in pixel.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getId()
Consente di acquisire l'ID dell'immagine.
Ritorni
String
: l'ID immagine
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLayout()
Restituisce un valore enum che rappresenta il layout dell'immagine.
Ritorni
PositionedLayout
: il layout dell'immagine
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLeftOffset()
Restituisce l'offset dell'immagine, in punti, dal bordo sinistro del paragrafo.
Ritorni
Number
: lo scostamento dell'immagine dal paragrafo sinistro a sinistra
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParagraph()
Recupera il Paragraph
a cui è ancorata l'immagine.
Ritorni
Paragraph
: paragrafo principale
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTopOffset()
Restituisce l'offset dell'immagine, in punti, dall'alto del paragrafo.
Ritorni
Number
: l'offset dell'immagine a partire dall'alto del paragrafo a sinistra
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getWidth()
Recupera la larghezza dell'immagine in pixel.
Ritorni
Integer
: la larghezza dell'immagine, in pixel.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setHeight(height)
Imposta l'altezza dell'immagine in pixel.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
height | Integer | l'altezza dell'immagine, in pixel. |
Ritorni
PositionedImage
: l'oggetto corrente
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLayout(layout)
Imposta la definizione del layout dell'immagine.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
layout | PositionedLayout | un'enum che rappresenta la modalità di layout |
Ritorni
PositionedImage
: questo oggetto per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLeftOffset(offset)
Imposta l'offset dell'immagine, in punti, dal lato sinistro del paragrafo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Number | scostamento da sinistra del paragrafo |
Ritorni
PositionedImage
: questo oggetto per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTopOffset(offset)
Imposta l'offset dell'immagine, in punti, dal bordo superiore del paragrafo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Number | sfalsamento rispetto al bordo superiore del paragrafo |
Ritorni
PositionedImage
: questo oggetto per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setWidth(width)
Imposta la larghezza dell'immagine in pixel.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
width | Integer | La larghezza dell'immagine, in pixel. |
Ritorni
PositionedImage
: l'oggetto corrente
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents