Class PositionedImage

PositionedImage

Immagine in posizione fissa ancorata a un Paragraph. A differenza di un InlineImage, un PositionedImage non è un Element. Non ha un genitore o un fratello Element. Viene invece ancorato a un Paragraph o ListItem e posizionato tramite offset rispetto a questo ancoraggio. Un PositionedImage ha un ID che può essere utilizzato per farvi riferimento. 

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

MetodoTipo restituitoBreve descrizione
getAs(contentType)BlobRestituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato.
getBlob()BlobRestituisce i dati all'interno di questo oggetto come blob.
getHeight()IntegerRecupera l'altezza dell'immagine, in pixel.
getId()StringRecupera l'ID dell'immagine.
getLayout()PositionedLayoutOttiene un valore enum che rappresenta il layout dell'immagine.
getLeftOffset()NumberRestituisce l'offset dell'immagine, in punti, dal lato sinistro del paragrafo.
getParagraph()ParagraphRestituisce il Paragraph a cui è ancorata l'immagine.
getTopOffset()NumberRestituisce l'offset dell'immagine, in punti, dalla parte superiore del paragrafo.
getWidth()IntegerRecupera la larghezza dell'immagine, in pixel.
setHeight(height)PositionedImageImposta l'altezza dell'immagine, in pixel.
setLayout(layout)PositionedImageImposta la definizione del layout dell'immagine.
setLeftOffset(offset)PositionedImageImposta l'offset dell'immagine, in punti, dal lato sinistro del paragrafo.
setTopOffset(offset)PositionedImageImposta l'offset dell'immagine, in punti, dalla parte superiore del paragrafo.
setWidth(width)PositionedImageImposta 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, si presume 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ù rigide.

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, sono validi anche 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'. Per un documento Google, è valido anche 'text/markdown'.

Indietro

Blob: i dati come blob.

getBlob()

Restituisce i dati all'interno di questo oggetto come blob.

Indietro

Blob: i dati come blob.

getHeight()

Recupera l'altezza dell'immagine, in pixel.

Indietro

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.

Indietro

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 layout dell'immagine.

Indietro

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.

Indietro

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

Restituisce il Paragraph a cui è ancorata l'immagine.

Indietro

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.

Indietro

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.

Indietro

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

NomeTipoDescrizione
heightIntegerl'altezza dell'immagine, in pixel

Indietro

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

NomeTipoDescrizione
layoutPositionedLayoutun'enumerazione che rappresenta la modalità di layout

Indietro

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

NomeTipoDescrizione
offsetNumberoffset dal lato sinistro del paragrafo

Indietro

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

Parametri

NomeTipoDescrizione
offsetNumberoffset dalla parte superiore del paragrafo

Indietro

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

NomeTipoDescrizione
widthIntegerla larghezza dell'immagine, in pixel

Indietro

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