Esta página foi traduzida pela API Cloud Translation.

Class PositionedImage

(link em inglês)

Correção da imagem de posição fixada em um Paragraph. Ao contrário de um InlineImage, um PositionedImage não é um Element. Ele não tem um Element pai ou irmão. Em vez disso, ele é ancorado em um Paragraph ou ListItem e é colocado por meio de deslocamentos dessa âncora. Um PositionedImage tem um ID que pode ser usado como referência.

var body = DocumentApp.getActiveDocument().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);

Métodos

Método	Tipo de retorno	Breve descrição
`getAs(contentType)`	`Blob`	Retorna os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado.
`getBlob()`	`Blob`	Retorne os dados dentro desse objeto como um blob.
`getHeight()`	`Integer`	Recupera a altura da imagem em pixels.
`getId()`	`String`	Recebe o ID da imagem.
`getLayout()`	`PositionedLayout`	Recebe um valor de enumeração que representa como a imagem é exibida.
`getLeftOffset()`	`Number`	Recebe o deslocamento da imagem, em pontos, do parágrafo à esquerda.
`getParagraph()`	`Paragraph`	Recebe o `Paragraph` em que a imagem está fixada.
`getTopOffset()`	`Number`	Recebe o deslocamento da imagem, em pontos, da parte superior do parágrafo.
`getWidth()`	`Integer`	Recupera a largura da imagem em pixels.
`setHeight(height)`	`PositionedImage`	Define a altura da imagem em pixels.
`setLayout(layout)`	`PositionedImage`	Define a definição de como a imagem é exibida.
`setLeftOffset(offset)`	`PositionedImage`	Define o deslocamento da imagem, em pontos, do parágrafo à esquerda.
`setTopOffset(offset)`	`PositionedImage`	Define o deslocamento da imagem, em pontos, na parte superior do parágrafo.
`setWidth(width)`	`PositionedImage`	Define a largura da imagem em pixels.

Documentação detalhada

`getAs(contentType)`

Retorna os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado. Esse método adiciona a extensão apropriada ao nome do arquivo, por exemplo, "myfile.pdf". No entanto, supõe que a parte do nome do arquivo que segue o último período (se houver) é uma extensão existente que precisa ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ShoppingList.12.25.pdf".

Para ver as cotas diárias de conversões, consulte Cotas do Google Services. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a cotas mais rígidas.

Parâmetros

Nome	Tipo	Descrição
`contentType`	`String`	O tipo MIME para o qual será feita a conversão. Para a maioria dos blobs, `'application/pdf'` é a única opção válida. Para imagens nos formatos BMP, GIF, JPEG ou PNG, qualquer um dos `'image/bmp'`, `'image/gif'`, `'image/jpeg'` ou `'image/png'` também é válido.

Retornar

Blob: os dados como um blob.

`getBlob()`

Retorne os dados dentro desse objeto como um blob.

Retornar

Blob: os dados como um blob.

`getHeight()`

Recupera a altura da imagem em pixels.

Retornar

Integer: a altura da imagem em pixels.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getId()`

Recebe o ID da imagem.

Retornar

String: o ID da imagem.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getLayout()`

Recebe um valor de enumeração que representa como a imagem é exibida.

Retornar

PositionedLayout: o layout da imagem.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getLeftOffset()`

Recebe o deslocamento da imagem, em pontos, do parágrafo à esquerda.

Retornar

Number: o deslocamento da imagem do parágrafo à esquerda.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getParagraph()`

Recebe o Paragraph em que a imagem está fixada.

Retornar

Paragraph: o parágrafo pai

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getTopOffset()`

Recebe o deslocamento da imagem, em pontos, da parte superior do parágrafo.

Retornar

Number: o deslocamento da imagem do parágrafo à esquerda, na parte superior.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getWidth()`

Recupera a largura da imagem em pixels.

Retornar

Integer: a largura da imagem em pixels.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setHeight(height)`

Define a altura da imagem em pixels.

Parâmetros

Nome	Tipo	Descrição
`height`	`Integer`	altura da imagem, em pixels

Retornar

PositionedImage: o objeto atual

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLayout(layout)`

Define a definição de como a imagem é exibida.

Parâmetros

Nome	Tipo	Descrição
`layout`	`PositionedLayout`	uma enumeração que representa o modo de layout.

Retornar

PositionedImage: este objeto para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLeftOffset(offset)`

Define o deslocamento da imagem, em pontos, do parágrafo à esquerda.

Parâmetros

Nome	Tipo	Descrição
`offset`	`Number`	deslocamento do parágrafo à esquerda

Retornar

PositionedImage: este objeto para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setTopOffset(offset)`

Define o deslocamento da imagem, em pontos, na parte superior do parágrafo.

Parâmetros

Nome	Tipo	Descrição
`offset`	`Number`	deslocamento da parte superior dos parágrafos

Retornar

PositionedImage: este objeto para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setWidth(width)`

Define a largura da imagem em pixels.

Parâmetros

Nome	Tipo	Descrição
`width`	`Integer`	largura da imagem, em pixels

Retornar

PositionedImage: o objeto atual

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents