Questa pagina è stata tradotta dall'API Cloud Translation.

Class PositionedImage

Immagine con posizione fissa ancorata a un Paragraph. A differenza di un InlineImage, un PositionedImage non è un Element. Non ha un elemento principale o un elemento fratello Element. È invece ancorato a un Paragraph o ListItem e viene posizionato tramite offset da quell'ancora. Un PositionedImage ha un ID che può essere utilizzato per fare riferimento a questo.

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

Metodi

Metodo	Tipo restituito	Breve descrizione
`getAs(contentType)`	`Blob`	Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato.
`getBlob()`	`Blob`	Restituisce i dati all'interno di questo oggetto come blob.
`getHeight()`	`Integer`	Recupera l'altezza dell'immagine in pixel.
`getId()`	`String`	Recupera l'ID dell'immagine.
`getLayout()`	`PositionedLayout`	Restituisce un valore enum che rappresenta la disposizione dell'immagine.
`getLeftOffset()`	`Number`	Restituisce l'offset dell'immagine, in punti, dal lato sinistro del paragrafo.
`getParagraph()`	`Paragraph`	Recupera il `Paragraph` a cui è ancorata l'immagine.
`getTopOffset()`	`Number`	Restituisce l'offset dell'immagine, in punti, dalla parte superiore 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 della disposizione 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, dalla parte 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 come blob convertito nel tipo di contenuti specificato. Questo metodo aggiunge l'estensione appropriata al nome file, ad esempio "myfile.pdf". Tuttavia, assume che la parte del nome 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 a 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, sono validi anche `'image/bmp'`, `'image/gif'`, `'image/jpeg'` o `'image/png'`. Per un documento di Documenti Google, è valido anche `'text/markdown'`.

Invio

Blob: i dati come blob.

`getBlob()`

Restituisce i dati all'interno di questo oggetto come 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()`

Restituisce un valore enum che rappresenta la disposizione dell'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, dal lato sinistro del paragrafo.

Invio

Number: l'offset dell'immagine rispetto al 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()`

Recupera 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, dalla parte superiore del paragrafo.

Invio

Number: l'offset dell'immagine rispetto alla parte superiore 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.

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

Imposta 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)`

Imposta la definizione della disposizione dell'immagine.

Parametri

Nome	Tipo	Descrizione
`layout`	`PositionedLayout`	un enum che rappresenta la modalità di layout

Invio

PositionedImage: questo oggetto per l'accodamento

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`	offset dal lato sinistro del paragrafo

Invio

PositionedImage: questo oggetto per l'accodamento

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, dalla parte superiore del paragrafo.

Parametri

Nome	Tipo	Descrizione
`offset`	`Number`	offset dalla parte superiore del paragrafo

Invio

PositionedImage: questo oggetto per l'accodamento

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

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