Immagine con posizione fissa ancorata a Paragraph
. A differenza di InlineImage
, un PositionedImage
è
non Element
. Non dispone di
genitore o pari livello Element
. Invece,
è ancorato a Paragraph
o ListItem
e viene posizionato tramite offset da
l'ancoraggio. Un PositionedImage
ha un ID che può essere utilizzato come riferimento.
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);
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. |
getBlob() | Blob | Restituisce i dati all'interno dell'oggetto sotto forma di blob. |
getHeight() | Integer | Recupera l'altezza dell'immagine in pixel. |
getId() | String | Recupera l'ID dell'immagine. |
getLayout() | PositionedLayout | Ottiene un valore enum che rappresenta il modo in cui è strutturata l'immagine. |
getLeftOffset() | Number | Restituisce l'offset dell'immagine, in punti, dalla sinistra del paragrafo. |
getParagraph() | Paragraph | Ottiene 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 | Consente di impostare l'altezza dell'immagine in pixel. |
setLayout(layout) | PositionedImage | Consente di impostare la definizione dell'aspetto dell'immagine. |
setLeftOffset(offset) | PositionedImage | Consente di impostare l'offset dell'immagine, in punti, dal lato sinistro del paragrafo. |
setTopOffset(offset) | PositionedImage | Consente di impostare l'offset dell'immagine, in punti, dal bordo superiore del paragrafo. |
setWidth(width) | PositionedImage | Consente di impostare la larghezza dell'immagine, in pixel. |
Documentazione dettagliata
getAs(contentType)
Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. Questo aggiunge l'estensione appropriata al nome del file, ad esempio "miofile.pdf". Tuttavia, presuppone che la parte del nome file che segue l'ultimo punto (se presente) sia una un'estensione che deve essere sostituita. Di conseguenza, "ShoppingList.25.12.2014" diventa "ShoppingList.12.25.pdf".
Per visualizzare le quote giornaliere per le conversioni, consulta Quote per Google Servizi. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a restrizioni quote.
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, vengono visualizzati anche i valori 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png'
valida. Per un documento di Documenti Google è valido anche 'text/markdown' . |
Invio
Blob
: i dati come blob.
getBlob()
Restituisce i dati all'interno dell'oggetto sotto forma di blob.
Invio
Blob
: i dati come blob.
getHeight()
Recupera l'altezza dell'immagine in pixel.
Invio
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()
Recupera l'ID dell'immagine.
Invio
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()
Ottiene un valore enum che rappresenta il modo in cui è strutturata l'immagine.
Invio
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, dalla sinistra del paragrafo.
Invio
Number
: l'offset dell'immagine dal lato sinistro 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
getParagraph()
Ottiene il Paragraph
a cui è ancorata l'immagine.
Invio
Paragraph
: il 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.
Invio
Number
: l'offset dell'immagine dal bordo superiore del paragrafo sinistro
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.
Invio
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)
Consente di impostare l'altezza dell'immagine in pixel.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
height | Integer | l'altezza dell'immagine, in pixel |
Invio
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)
Consente di impostare la definizione dell'aspetto dell'immagine.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
layout | PositionedLayout | un'enumerazione che rappresenta la modalità di layout |
Invio
PositionedImage
: questo oggetto per il collegamento
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)
Consente di impostare l'offset dell'immagine, in punti, dal lato sinistro del paragrafo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Number | sfalsato dal lato sinistro del paragrafo |
Invio
PositionedImage
: questo oggetto per il collegamento
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)
Consente di impostare l'offset dell'immagine, in punti, dal bordo superiore del paragrafo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Number | sfalsato rispetto alla parte superiore del paragrafo |
Invio
PositionedImage
: questo oggetto per il collegamento
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)
Consente di impostare la larghezza dell'immagine, in pixel.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
width | Integer | la larghezza dell'immagine, in pixel |
Invio
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