Questa pagina è stata tradotta dall'API Cloud Translation.

Class PositionedImage

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