Class PositionedImage

Позиционированное изображение

Изображение с фиксированным положением, привязанное к Paragraph . В отличие от InlineImage , PositionedImage не является Element . У него нет родительского или родственного Element . Вместо этого он привязан к Paragraph или ListItem и размещается через смещения от этой привязки. PositionedImage имеет идентификатор, который можно использовать для ссылки на него.

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

Методы

Метод Тип возврата Краткое описание
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