Se usó la API de Cloud Translation para traducir esta página.

Class PositionedImage

Imagen de posición fija anclada a un Paragraph A diferencia de InlineImage, PositionedImage es no es Element. No contiene un superior o del mismo nivel: Element. En cambio, está anclada a un Paragraph o una ListItem, y se coloca mediante compensaciones de sobre ese ancla. Un elemento PositionedImage tiene un ID que se puede usar para hacer referencia a él.

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

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`getAs(contentType)`	`Blob`	Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado.
`getBlob()`	`Blob`	Muestra los datos dentro de este objeto como un BLOB.
`getHeight()`	`Integer`	Recupera la altura de la imagen en píxeles.
`getId()`	`String`	Obtiene el ID de la imagen.
`getLayout()`	`PositionedLayout`	Obtiene un valor de enumeración que representa la disposición de la imagen.
`getLeftOffset()`	`Number`	Obtiene el desplazamiento de la imagen, en puntos, desde la izquierda del párrafo.
`getParagraph()`	`Paragraph`	Obtiene el `Paragraph` al que está anclada la imagen.
`getTopOffset()`	`Number`	Obtiene el desplazamiento de la imagen, en puntos, desde la parte superior del párrafo.
`getWidth()`	`Integer`	Recupera el ancho de la imagen en píxeles.
`setHeight(height)`	`PositionedImage`	Establece la altura de la imagen en píxeles.
`setLayout(layout)`	`PositionedImage`	Establece la definición de cómo se presenta la imagen.
`setLeftOffset(offset)`	`PositionedImage`	Establece el desplazamiento de la imagen, en puntos, desde la izquierda del párrafo.
`setTopOffset(offset)`	`PositionedImage`	Establece el desplazamiento de la imagen, en puntos, desde la parte superior del párrafo.
`setWidth(width)`	`PositionedImage`	Establece el ancho de la imagen en píxeles.

Documentación detallada

`getAs(contentType)`

Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado. Esta agrega la extensión adecuada al nombre del archivo, por ejemplo, "miarchivo.pdf". Sin embargo, supone que la parte del nombre de archivo que sigue al último punto (si corresponde) es una parte extensión que debe reemplazarse. Por lo tanto, "ShoppingList.12.25.2014" se convierte en “ShoppingList.12.25.pdf”.

Para ver las cuotas diarias de las conversiones, consulta Cuotas para Google Servicios Es posible que los dominios de Google Workspace recién creados estén sujetos temporalmente a restricciones y cuotas.

Parámetros

Nombre	Tipo	Descripción
`contentType`	`String`	El tipo de MIME en el que se convertirá. Para la mayoría de los BLOB, `'application/pdf'` es la única opción válida. En el caso de las imágenes en formato BMP, GIF, JPEG o PNG, también se aplica cualquiera de los siguientes valores: `'image/bmp'`, `'image/gif'`, `'image/jpeg'` o `'image/png'`. válido. `'text/markdown'` también es válido para Documentos de Google.

Volver

Blob: Los datos como un BLOB.

`getBlob()`

Muestra los datos dentro de este objeto como un BLOB.

Volver

Blob: Los datos como un BLOB.

`getHeight()`

Recupera la altura de la imagen en píxeles.

Volver

Integer: Es la altura de la imagen en píxeles.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getId()`

Obtiene el ID de la imagen.

Volver

String: Es el ID de la imagen.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getLayout()`

Obtiene un valor de enumeración que representa la disposición de la imagen.

Volver

PositionedLayout: Es el diseño de la imagen.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getLeftOffset()`

Obtiene el desplazamiento de la imagen, en puntos, desde la izquierda del párrafo.

Volver

Number: Es el desplazamiento de la imagen desde la izquierda del párrafo izquierdo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getParagraph()`

Obtiene el Paragraph al que está anclada la imagen.

Volver

Paragraph: Es el párrafo superior.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getTopOffset()`

Obtiene el desplazamiento de la imagen, en puntos, desde la parte superior del párrafo.

Volver

Number: Es el desplazamiento de la imagen desde la parte superior del párrafo izquierdo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getWidth()`

Recupera el ancho de la imagen en píxeles.

Volver

Integer: Es el ancho de la imagen en píxeles.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`setHeight(height)`

Establece la altura de la imagen en píxeles.

Parámetros

Nombre	Tipo	Descripción
`height`	`Integer`	la altura de la imagen en píxeles

Volver

PositionedImage: Es el objeto actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`setLayout(layout)`

Establece la definición de cómo se presenta la imagen.

Parámetros

Nombre	Tipo	Descripción
`layout`	`PositionedLayout`	una enumeración que representa el modo de diseño

Volver

PositionedImage: Este objeto para el encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`setLeftOffset(offset)`

Establece el desplazamiento de la imagen, en puntos, desde la izquierda del párrafo.

Parámetros

Nombre	Tipo	Descripción
`offset`	`Number`	desplazamiento desde la izquierda del párrafo

Volver

PositionedImage: Este objeto para el encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`setTopOffset(offset)`

Establece el desplazamiento de la imagen, en puntos, desde la parte superior del párrafo.

Parámetros

Nombre	Tipo	Descripción
`offset`	`Number`	desplazamiento desde la parte superior del párrafo

Volver

PositionedImage: Este objeto para el encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`setWidth(width)`

Establece el ancho de la imagen en píxeles.

Parámetros

Nombre	Tipo	Descripción
`width`	`Integer`	el ancho de la imagen en píxeles

Volver

PositionedImage: Es el objeto actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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