Class PositionedImage

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

Изображение с фиксированным положением, привязанное к Paragraph . В отличие от Inline Image , Positioned Image не является Element . У него нет родительского или родственного Element . Вместо этого он привязан к элементу Paragraph или List Item и размещается через смещения от этой привязки. Positioned Image имеет идентификатор, который можно использовать для ссылки на него. 

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

Методы

Метод Тип возврата Краткое описание
get As(contentType) Blob Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента.
get Blob() Blob Верните данные внутри этого объекта в виде большого двоичного объекта.
get Height() Integer Получает высоту изображения в пикселях.
get Id() String Получает идентификатор изображения.
get Layout() Positioned Layout Получает значение перечисления, которое показывает, как расположено изображение.
get Left Offset() Number Получает смещение изображения в пунктах от левого абзаца.
get Paragraph() Paragraph Получает Paragraph к которому привязано изображение.
get Top Offset() Number Получает смещение изображения (в пунктах) от верхнего края абзаца.
get Width() Integer Получает ширину изображения в пикселях.
set Height(height) Positioned Image Устанавливает высоту изображения в пикселях.
set Layout(layout) Positioned Image Устанавливает определение компоновки изображения.
set Left Offset(offset) Positioned Image Устанавливает смещение изображения в пунктах от левого абзаца.
set Top Offset(offset) Positioned Image Устанавливает смещение изображения в пунктах от верха абзаца.
set Width(width) Positioned Image Устанавливает ширину изображения в пикселях.

Подробная документация

get As(contentType)

Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента. Этот метод добавляет к имени файла соответствующее расширение, например «myfile.pdf». Однако предполагается, что часть имени файла, следующая за последней точкой (если таковая имеется), является существующим расширением, которое следует заменить. Следовательно, «Список покупок.25.12.2014» становится «Список покупок.12.25.pdf».

Чтобы просмотреть ежедневные квоты на конверсии, см. Квоты для сервисов Google . На вновь созданные домены Google Workspace могут временно распространяться более строгие квоты.

Параметры

Имя Тип Описание
content Type String Тип MIME, в который требуется преобразовать. Для большинства больших двоичных объектов единственным допустимым вариантом является 'application/pdf' . Для изображений в формате BMP, GIF, JPEG или PNG также допустимо любое из 'image/bmp' , 'image/gif' , 'image/jpeg' или 'image/png' . Для документа Google Docs также допустимо использование 'text/markdown' .

Возвращаться

Blob — данные в виде большого двоичного объекта.

get Blob()

Верните данные внутри этого объекта в виде большого двоичного объекта.

Возвращаться

Blob — данные в виде большого двоичного объекта.

get Height()

Получает высоту изображения в пикселях.

Возвращаться

Integer — высота изображения в пикселях.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Id()

Получает идентификатор изображения.

Возвращаться

String — идентификатор изображения

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Layout()

Получает значение перечисления, которое показывает, как расположено изображение.

Возвращаться

Positioned Layout — макет изображения.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Left Offset()

Получает смещение изображения в пунктах от левого абзаца.

Возвращаться

Number — смещение изображения от левого абзаца.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Paragraph()

Получает Paragraph к которому привязано изображение.

Возвращаться

Paragraph — родительский абзац

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Top Offset()

Получает смещение изображения (в пунктах) от верхнего края абзаца.

Возвращаться

Number — смещение изображения от верхнего края левого абзаца.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Width()

Получает ширину изображения в пикселях.

Возвращаться

Integer — ширина изображения в пикселях.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

set Height(height)

Устанавливает высоту изображения в пикселях.

Параметры

Имя Тип Описание
height Integer высота изображения в пикселях

Возвращаться

Positioned Image — текущий объект

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

set Layout(layout)

Устанавливает определение компоновки изображения.

Параметры

Имя Тип Описание
layout Positioned Layout перечисление, представляющее режим макета

Возвращаться

Positioned Image — этот объект для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

set Left Offset(offset)

Устанавливает смещение изображения в пунктах от левого абзаца.

Параметры

Имя Тип Описание
offset Number смещение слева от абзаца

Возвращаться

Positioned Image — этот объект для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

set Top Offset(offset)

Устанавливает смещение изображения в пунктах от верха абзаца.

Параметры

Имя Тип Описание
offset Number смещение от верха абзаца

Возвращаться

Positioned Image — этот объект для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

set Width(width)

Устанавливает ширину изображения в пикселях.

Параметры

Имя Тип Описание
width Integer ширина изображения в пикселях

Возвращаться

Positioned Image — текущий объект

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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