Изображение с фиксированным положением, привязанное к Paragraph
. В отличие от InlineImage
, PositionedImage
не является Element
. У него нет родительского или родственного Element
. Вместо этого он привязан к Paragraph
или ListItem
и размещается через смещения от этой привязки. PositionedImage
имеет идентификатор, который можно использовать для ссылки на него.
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);
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
getAs(contentType) | Blob | Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента. |
getBlob() | Blob | Верните данные внутри этого объекта в виде большого двоичного объекта. |
getHeight() | Integer | Получает высоту изображения в пикселях. |
getId() | String | Получает идентификатор изображения. |
getLayout() | PositionedLayout | Получает значение перечисления, которое показывает, как расположено изображение. |
getLeftOffset() | Number | Получает смещение изображения в пунктах от левого абзаца. |
getParagraph() | Paragraph | Получает Paragraph к которому привязано изображение. |
getTopOffset() | Number | Получает смещение изображения (в пунктах) от верхнего края абзаца. |
getWidth() | Integer | Получает ширину изображения в пикселях. |
setHeight(height) | PositionedImage | Устанавливает высоту изображения в пикселях. |
setLayout(layout) | PositionedImage | Устанавливает определение компоновки изображения. |
setLeftOffset(offset) | PositionedImage | Устанавливает смещение изображения в пунктах от левого абзаца. |
setTopOffset(offset) | PositionedImage | Устанавливает смещение изображения в пунктах от верха абзаца. |
setWidth(width) | PositionedImage | Устанавливает ширину изображения в пикселях. |
Подробная документация
getAs(contentType)
Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента. Этот метод добавляет к имени файла соответствующее расширение, например «myfile.pdf». Однако предполагается, что часть имени файла, следующая за последней точкой (если таковая имеется), является существующим расширением, которое следует заменить. Следовательно, «Список покупок.25.12.2014» становится «Список покупок.12.25.pdf».
Чтобы просмотреть ежедневные квоты на конверсии, см. Квоты для сервисов Google . На вновь созданные домены Google Workspace могут временно распространяться более строгие квоты.
Параметры
Имя | Тип | Описание |
---|---|---|
contentType | String | Тип MIME, в который требуется преобразовать. Для большинства больших двоичных объектов единственным допустимым вариантом является 'application/pdf' . Для изображений в формате BMP, GIF, JPEG или PNG также допустимо любое из 'image/bmp' , 'image/gif' , 'image/jpeg' или 'image/png' . Для документа Google Docs также допустимо использование 'text/markdown' . |
Возвращаться
Blob
— данные в виде большого двоичного объекта.
getBlob()
Верните данные внутри этого объекта в виде большого двоичного объекта.
Возвращаться
Blob
— данные в виде большого двоичного объекта.
getHeight()
Получает высоту изображения в пикселях.
Возвращаться
Integer
— высота изображения в пикселях.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getId()
Получает идентификатор изображения.
Возвращаться
String
— идентификатор изображения
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLayout()
Получает значение перечисления, которое показывает, как расположено изображение.
Возвращаться
PositionedLayout
— макет изображения
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLeftOffset()
Получает смещение изображения в пунктах от левого абзаца.
Возвращаться
Number
— смещение изображения от левого абзаца.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParagraph()
Получает Paragraph
к которому привязано изображение.
Возвращаться
Paragraph
— родительский абзац
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTopOffset()
Получает смещение изображения (в пунктах) от верхнего края абзаца.
Возвращаться
Number
— смещение изображения от верхнего края левого абзаца.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getWidth()
Получает ширину изображения в пикселях.
Возвращаться
Integer
— ширина изображения в пикселях.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setHeight(height)
Устанавливает высоту изображения в пикселях.
Параметры
Имя | Тип | Описание |
---|---|---|
height | Integer | высота изображения в пикселях |
Возвращаться
PositionedImage
— текущий объект
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLayout(layout)
Устанавливает определение компоновки изображения.
Параметры
Имя | Тип | Описание |
---|---|---|
layout | PositionedLayout | перечисление, представляющее режим макета |
Возвращаться
PositionedImage
— этот объект для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLeftOffset(offset)
Устанавливает смещение изображения в пунктах от левого абзаца.
Параметры
Имя | Тип | Описание |
---|---|---|
offset | Number | смещение слева от абзаца |
Возвращаться
PositionedImage
— этот объект для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTopOffset(offset)
Устанавливает смещение изображения в пунктах от верха абзаца.
Параметры
Имя | Тип | Описание |
---|---|---|
offset | Number | смещение от верха абзаца |
Возвращаться
PositionedImage
— этот объект для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setWidth(width)
Устанавливает ширину изображения в пикселях.
Параметры
Имя | Тип | Описание |
---|---|---|
width | Integer | ширина изображения в пикселях |
Возвращаться
PositionedImage
— текущий объект
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents