Class PositionedImage

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

MetodoTipo restituitoBreve descrizione
getAs(contentType)BlobRestituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato.
getBlob()BlobRestituisce i dati all'interno dell'oggetto sotto forma di blob.
getHeight()IntegerRecupera l'altezza dell'immagine in pixel.
getId()StringRecupera l'ID dell'immagine.
getLayout()PositionedLayoutOttiene un valore enum che rappresenta il modo in cui è strutturata l'immagine.
getLeftOffset()NumberRestituisce l'offset dell'immagine, in punti, dalla sinistra del paragrafo.
getParagraph()ParagraphOttiene il Paragraph a cui è ancorata l'immagine.
getTopOffset()NumberRestituisce l'offset dell'immagine, in punti, dall'alto del paragrafo.
getWidth()IntegerRecupera la larghezza dell'immagine, in pixel.
setHeight(height)PositionedImageConsente di impostare l'altezza dell'immagine in pixel.
setLayout(layout)PositionedImageConsente di impostare la definizione dell'aspetto dell'immagine.
setLeftOffset(offset)PositionedImageConsente di impostare l'offset dell'immagine, in punti, dal lato sinistro del paragrafo.
setTopOffset(offset)PositionedImageConsente di impostare l'offset dell'immagine, in punti, dal bordo superiore del paragrafo.
setWidth(width)PositionedImageConsente 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

NomeTipoDescrizione
contentTypeStringIl 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

NomeTipoDescrizione
heightIntegerl'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

NomeTipoDescrizione
layoutPositionedLayoutun'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

NomeTipoDescrizione
offsetNumbersfalsato 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

NomeTipoDescrizione
offsetNumbersfalsato 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

NomeTipoDescrizione
widthIntegerla 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