Class Image

Изображение

PageElement представляющий изображение.

Методы

Метод Тип возврата Краткое описание
alignOnPage(alignmentPosition) Image Выравнивает элемент по указанной позиции выравнивания на странице.
bringForward() Image Перемещает элемент страницы вперед на один элемент.
bringToFront() Image Выводит элемент страницы на передний план страницы.
duplicate() PageElement Дублирует элемент страницы.
getAs(contentType) Blob Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента.
getBlob() Blob Верните данные внутри этого изображения в виде большого двоичного объекта.
getBorder() Border Возвращает Border изображения.
getConnectionSites() ConnectionSite[] Возвращает список ConnectionSite в элементе страницы или пустой список, если элемент страницы не имеет сайтов подключения.
getContentUrl() String Получает URL-адрес изображения.
getDescription() String Возвращает описание альтернативного текста элемента страницы.
getHeight() Number Получает высоту элемента в пунктах, которая является высотой ограничивающей рамки элемента, когда элемент не имеет поворота.
getInherentHeight() Number Возвращает внутреннюю высоту элемента в пунктах.
getInherentWidth() Number Возвращает внутреннюю ширину элемента в пунктах.
getLeft() Number Возвращает горизонтальное положение элемента в точках, измеренное от левого верхнего угла страницы, когда элемент не имеет поворота.
getLink() Link Возвращает Link или null если ссылки нет.
getObjectId() String Возвращает уникальный идентификатор для этого объекта.
getPageElementType() PageElementType Возвращает тип элемента страницы, представленный в виде перечисления PageElementType .
getParentGroup() Group Возвращает группу, к которой принадлежит этот элемент страницы, или null если элемент не находится в группе.
getParentPage() Page Возвращает страницу, на которой находится этот элемент страницы.
getParentPlaceholder() PageElement Возвращает элемент родительской страницы заполнителя.
getPlaceholderIndex() Integer Возвращает индекс изображения-заполнителя.
getPlaceholderType() PlaceholderType Возвращает тип заполнителя изображения или PlaceholderType.NONE , если фигура не является заполнителем.
getRotation() Number Возвращает угол поворота элемента по часовой стрелке вокруг его центра в градусах, где ноль градусов означает отсутствие вращения.
getSourceUrl() String Получает URL-адрес источника изображения, если он доступен.
getTitle() String Возвращает заголовок альтернативного текста элемента страницы.
getTop() Number Получает положение элемента по вертикали в точках, измеренное от левого верхнего угла страницы, когда элемент не имеет поворота.
getTransform() AffineTransform Возвращает преобразование элемента страницы.
getWidth() Number Возвращает ширину элемента в пунктах, которая является шириной ограничивающей рамки элемента, когда элемент не имеет поворота.
preconcatenateTransform(transform) Image Предварительно объединяет предоставленное преобразование с существующим преобразованием элемента страницы.
remove() void Удаляет элемент страницы.
removeLink() void Удаляет Link .
replace(blobSource) Image Заменяет это изображение изображением, описанным объектом BlobSource .
replace(blobSource, crop) Image Заменяет это изображение изображением, описанным объектом Image , при необходимости обрезая изображение по размеру.
replace(imageUrl) Image Заменяет это изображение другим изображением, загруженным с указанного URL-адреса.
replace(imageUrl, crop) Image Заменяет это изображение другим изображением, загруженным с предоставленного URL-адреса, при необходимости обрезая изображение по размеру.
scaleHeight(ratio) Image Масштабирует высоту элемента в указанном соотношении.
scaleWidth(ratio) Image Масштабирует ширину элемента в указанном соотношении.
select() void Выбирает только PageElement в активной презентации и удаляет любой предыдущий выбор.
select(replace) void Выбирает PageElement в активной презентации.
sendBackward() Image Отправляет элемент страницы назад на один элемент.
sendToBack() Image Отправляет элемент страницы в конец страницы.
setDescription(description) Image Устанавливает описание замещающего текста элемента страницы.
setHeight(height) Image Устанавливает высоту элемента в пунктах, которая является высотой ограничивающей рамки элемента, когда элемент не имеет поворота.
setLeft(left) Image Устанавливает горизонтальное положение элемента в пунктах, измеряемое от верхнего левого угла страницы, когда элемент не имеет поворота.
setLinkSlide(slideIndex) Link Устанавливает Link на данный Slide , используя отсчитываемый от нуля индекс слайда.
setLinkSlide(slide) Link Устанавливает Link на данный Slide , ссылка устанавливается по заданному идентификатору слайда.
setLinkSlide(slidePosition) Link Устанавливает Link на данный Slide , используя относительное положение слайда.
setLinkUrl(url) Link Устанавливает Link на заданную непустую строку URL.
setRotation(angle) Image Задает угол поворота элемента по часовой стрелке вокруг его центра в градусах.
setTitle(title) Image Устанавливает заголовок альтернативного текста элемента страницы.
setTop(top) Image Задает положение элемента по вертикали в пунктах, измеряемое от левого верхнего угла страницы, когда элемент не имеет поворота.
setTransform(transform) Image Задает преобразование элемента страницы с предоставленным преобразованием.
setWidth(width) Image Устанавливает ширину элемента в пунктах, которая является шириной ограничивающей рамки элемента, когда элемент не имеет поворота.

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

alignOnPage(alignmentPosition)

Выравнивает элемент по указанной позиции выравнивания на странице.

Параметры

Имя Тип Описание
alignmentPosition AlignmentPosition Позиция для выравнивания этого элемента страницы на странице.

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

Image — этот элемент страницы для цепочки.

bringForward()

Перемещает элемент страницы вперед на один элемент.

Элемент страницы не должен находиться в группе.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

bringToFront()

Выводит элемент страницы на передний план страницы.

Элемент страницы не должен находиться в группе.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

duplicate()

Дублирует элемент страницы.

Дублирующий элемент страницы размещается на той же странице в том же месте, что и оригинал.

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

PageElement — новый дубликат этого элемента страницы.

Авторизация

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

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

getAs(contentType)

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

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

Параметры

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

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

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

getBlob()

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

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

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

getBorder()

Возвращает Border изображения.

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

Border — граница изображения.

Авторизация

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

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

getConnectionSites()

Возвращает список ConnectionSite в элементе страницы или пустой список, если элемент страницы не имеет сайтов подключения.

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

ConnectionSite[] — список сайтов подключения, который может быть пустым, если у этого элемента нет сайтов подключения.

Авторизация

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

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

getContentUrl()

Получает URL-адрес изображения.

Этот URL-адрес помечен учетной записью отправителя запроса, поэтому любой, у кого есть URL-адрес, фактически получает доступ к изображению как первоначальный запросчик. Доступ к изображению может быть потерян при изменении настроек общего доступа к презентации. Срок действия возвращенного URL истекает через короткий промежуток времени.

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

String

Авторизация

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

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

getDescription()

Возвращает описание альтернативного текста элемента страницы. Описание объединяется с заголовком для отображения и чтения замещающего текста.

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

String — описание замещающего текста элемента страницы.

Авторизация

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

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

getHeight()

Получает высоту элемента в пунктах, которая является высотой ограничивающей рамки элемента, когда элемент не имеет поворота.

Этот метод не совместим со всеми элементами страницы. Чтобы узнать, какие элементы страницы несовместимы с этим методом, ознакомьтесь с ограничениями по размеру и расположению .

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

Number — собственная высота элемента страницы в пунктах или null , если элемент страницы не имеет высоты.

Авторизация

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

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

getInherentHeight()

Возвращает внутреннюю высоту элемента в пунктах.

Преобразование элемента страницы зависит от его собственного размера. Используйте собственный размер в сочетании с преобразованием элемента, чтобы определить окончательный внешний вид элемента.

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

Number — собственная высота элемента страницы в пунктах или null , если элемент страницы не имеет высоты.

Авторизация

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

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

getInherentWidth()

Возвращает внутреннюю ширину элемента в пунктах.

Преобразование элемента страницы зависит от его собственного размера. Используйте собственный размер в сочетании с преобразованием элемента, чтобы определить окончательный внешний вид элемента.

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

Number — собственная ширина элемента страницы в пунктах или null , если элемент страницы не имеет ширины.

Авторизация

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

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

getLeft()

Возвращает горизонтальное положение элемента в точках, измеренное от левого верхнего угла страницы, когда элемент не имеет поворота.

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

Number — горизонтальное положение этого элемента в пунктах от левого верхнего угла страницы.

Авторизация

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

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

Возвращает Link или null если ссылки нет.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

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

Link

Авторизация

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

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

getObjectId()

Возвращает уникальный идентификатор для этого объекта. Идентификаторы объектов, используемые страницами и элементами страницы, имеют одно и то же пространство имен.

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

String — Уникальный идентификатор этого объекта.

Авторизация

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

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

getPageElementType()

Возвращает тип элемента страницы, представленный в виде перечисления PageElementType .

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

PageElementType — Тип элемента страницы.

Авторизация

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

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

getParentGroup()

Возвращает группу, к которой принадлежит этот элемент страницы, или null если элемент не находится в группе.

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

Group — группа, к которой принадлежит этот элемент страницы, или null .

Авторизация

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

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

getParentPage()

Возвращает страницу, на которой находится этот элемент страницы.

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

Page — страница, на которой находится этот элемент.

Авторизация

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

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

getParentPlaceholder()

Возвращает элемент родительской страницы заполнителя. Возвращает null если изображение не является заполнителем или не имеет родителя.

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

PageElement — Элемент родительской страницы этого заполнителя изображения или null , если это изображение не является заполнителем или не имеет родителя.

Авторизация

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

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

getPlaceholderIndex()

Возвращает индекс изображения-заполнителя. Если два или более изображений-заполнителей на одной странице относятся к одному типу, каждое из них имеет уникальное значение индекса. Возвращает null если изображение не является заполнителем.

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

Integer — индекс заполнителя этого изображения или null , если изображение не является заполнителем.

Авторизация

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

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

getPlaceholderType()

Возвращает тип заполнителя изображения или PlaceholderType.NONE , если фигура не является заполнителем.

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

PlaceholderType — тип заполнителя этого изображения.

Авторизация

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

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

getRotation()

Возвращает угол поворота элемента по часовой стрелке вокруг его центра в градусах, где ноль градусов означает отсутствие вращения.

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

Number — угол поворота в градусах от 0 (включительно) до 360 (не включая).

Авторизация

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

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

getSourceUrl()

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

Когда изображение вставляется по URL-адресу, возвращает URL-адрес, указанный во время вставки изображения.

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

String — URL-адрес изображения или null , если у изображения нет исходного URL-адреса.

Авторизация

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

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

getTitle()

Возвращает заголовок альтернативного текста элемента страницы. Заголовок объединяется с описанием для отображения и чтения замещающего текста.

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

String — Заголовок альтернативного текста элемента страницы.

Авторизация

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

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

getTop()

Получает положение элемента по вертикали в точках, измеренное от левого верхнего угла страницы, когда элемент не имеет поворота.

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

Number — вертикальное положение этого элемента в пунктах от левого верхнего угла страницы.

Авторизация

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

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

getTransform()

Возвращает преобразование элемента страницы.

Внешний вид элемента страницы определяется его абсолютным преобразованием. Чтобы вычислить абсолютное преобразование, предварительно объедините преобразование элемента страницы с преобразованиями всех его родительских групп. Если элемент страницы не входит в группу, его абсолютное преобразование совпадает со значением в этом поле.

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

AffineTransform — преобразование элемента страницы.

Авторизация

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

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

getWidth()

Возвращает ширину элемента в пунктах, которая является шириной ограничивающей рамки элемента, когда элемент не имеет поворота.

Этот метод не совместим со всеми элементами страницы. Чтобы узнать, какие элементы страницы несовместимы с этим методом, ознакомьтесь с ограничениями по размеру и расположению .

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

Number — собственная ширина элемента страницы в пунктах или null , если элемент страницы не имеет ширины.

Авторизация

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

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

preconcatenateTransform(transform)

Предварительно объединяет предоставленное преобразование с существующим преобразованием элемента страницы.

newTransform = argument * existingTransform

Например, чтобы переместить элементы страницы на 36 пунктов влево:

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

Вы также можете заменить преобразование элемента страницы на setTransform(transform) .

Параметры

Имя Тип Описание
transform AffineTransform Преобразование для предварительного объединения с преобразованием этого элемента страницы.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

remove()

Удаляет элемент страницы.

Если после операции удаления Group содержит только один элемент страницы или не содержит ни одного элемента, сама группа также удаляется.

Если заполнитель PageElement удаляется из образца или макета, все пустые наследуемые заполнители также удаляются.

Авторизация

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

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

Удаляет Link .

shape.removeLink();

replace(blobSource)

Заменяет это изображение изображением, описанным объектом BlobSource .

При вставке изображение извлекается из BlobSource один раз, а копия сохраняется для отображения в презентации. Изображения должны быть размером менее 50 МБ, не более 25 мегапикселей и должны быть в формате PNG, JPEG или GIF.

Чтобы сохранить пропорции изображения, изображение масштабируется и центрируется по отношению к размеру существующего изображения.

var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
image.replace(driveImage);

Параметры

Имя Тип Описание
blobSource BlobSource Данные изображения.

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

Image — это Image после замены.

Авторизация

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

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

replace(blobSource, crop)

Заменяет это изображение изображением, описанным объектом Image , при необходимости обрезая изображение по размеру.

При вставке изображение извлекается из BlobSource один раз, а копия сохраняется для отображения в презентации. Изображения должны быть размером менее 50 МБ, не более 25 мегапикселей и должны быть в формате PNG, JPEG или GIF.

var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the drive image.
image.replace(driveImage, true);

Параметры

Имя Тип Описание
blobSource BlobSource Данные изображения.
crop Boolean Если true , изображение обрезается до размера существующего изображения. В противном случае изображение масштабируется и центрируется.

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

Image — это Image после замены.

Авторизация

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

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

replace(imageUrl)

Заменяет это изображение другим изображением, загруженным с указанного URL-адреса.

При вставке изображения оно извлекается из URL-адреса один раз, а копия сохраняется для отображения внутри презентации. Изображения должны быть размером менее 50 МБ, не более 25 мегапикселей и должны быть в формате PNG, JPEG или GIF.

Предоставленный URL-адрес должен быть общедоступным и иметь размер не более 2 КБ. Сам URL-адрес сохраняется вместе с изображением и отображается через getSourceUrl() .

Чтобы сохранить пропорции изображения, изображение масштабируется и центрируется по отношению к размеру существующего изображения.

Параметры

Имя Тип Описание
imageUrl String URL-адрес для загрузки изображения.

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

Image — Это Image после замены.

Авторизация

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

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

replace(imageUrl, crop)

Заменяет это изображение другим изображением, загруженным с предоставленного URL-адреса, при необходимости обрезая изображение по размеру.

При вставке изображения оно извлекается из URL-адреса один раз, а копия сохраняется для отображения внутри презентации. Изображения должны быть размером менее 50 МБ, не более 25 мегапикселей и должны быть в формате PNG, JPEG или GIF.

Предоставленный URL-адрес не должен превышать 2 КБ.

Параметры

Имя Тип Описание
imageUrl String URL-адрес для загрузки изображения.
crop Boolean Если true , изображение обрезается до размера существующего изображения. В противном случае изображение масштабируется и центрируется.

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

Image — это Image после замены.

Авторизация

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

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

scaleHeight(ratio)

Масштабирует высоту элемента в указанном соотношении. Высота элемента — это высота его ограничивающей рамки, когда элемент не имеет поворота.

Этот метод не совместим со всеми элементами страницы. Чтобы узнать, какие элементы страницы несовместимы с этим методом, ознакомьтесь с ограничениями по размеру и расположению .

Параметры

Имя Тип Описание
ratio Number Коэффициент масштабирования высоты этого элемента страницы.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

scaleWidth(ratio)

Масштабирует ширину элемента в указанном соотношении. Ширина элемента — это ширина его ограничивающей рамки, когда элемент не имеет поворота.

Этот метод не совместим со всеми элементами страницы. Чтобы узнать, какие элементы страницы несовместимы с этим методом, ознакомьтесь с ограничениями по размеру и расположению .

Параметры

Имя Тип Описание
ratio Number Коэффициент масштабирования ширины этого элемента страницы.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

select()

Выбирает только PageElement в активной презентации и удаляет любой предыдущий выбор. Это то же самое, что и вызов select(replace) с помощью true .

Сценарий может получить доступ только к выбору пользователя, запустившего сценарий, и только в том случае, если сценарий привязан к презентации.

Это устанавливает родительскую Page PageElement в качестве current page selection .

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Авторизация

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

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

select(replace)

Выбирает PageElement в активной презентации.

Сценарий может получить доступ только к выбору пользователя, запустившего сценарий, и только в том случае, если сценарий привязан к презентации.

Передайте этому методу true , чтобы выбрать только PageElement и удалить любой предыдущий выбор. Это также устанавливает родительскую Page PageElement в качестве current page selection .

Передайте false , чтобы выбрать несколько объектов PageElement . Объекты PageElement должны находиться на одной Page .

При выборе элемента страницы с параметром false должны выполняться следующие условия:

  1. Родительская Page объекта PageElement должна быть current page selection .
  2. Не должно быть выбрано несколько объектов Page .

Чтобы убедиться, что это так, предпочтительный подход состоит в том, чтобы сначала выбрать родительскую Page с помощью Page.selectAsCurrentPage() , а затем выбрать элементы страницы на этой странице.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Параметры

Имя Тип Описание
replace Boolean Если true , выбор заменяет любой предыдущий выбор; в противном случае выбор добавляется к любому предыдущему выбору.

Авторизация

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

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

sendBackward()

Отправляет элемент страницы назад на один элемент.

Элемент страницы не должен находиться в группе.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

sendToBack()

Отправляет элемент страницы в конец страницы.

Элемент страницы не должен находиться в группе.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

setDescription(description)

Устанавливает описание замещающего текста элемента страницы.

Метод не поддерживается для элементов Group .

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Параметры

Имя Тип Описание
description String Строка для установки альтернативного текстового описания.

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

Image — этот элемент страницы.

Авторизация

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

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

setHeight(height)

Устанавливает высоту элемента в пунктах, которая является высотой ограничивающей рамки элемента, когда элемент не имеет поворота.

Этот метод не совместим со всеми элементами страницы. Чтобы узнать, какие элементы страницы несовместимы с этим методом, ознакомьтесь с ограничениями по размеру и расположению .

Параметры

Имя Тип Описание
height Number Новая высота этого элемента страницы для установки в пунктах.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

setLeft(left)

Устанавливает горизонтальное положение элемента в пунктах, измеряемое от верхнего левого угла страницы, когда элемент не имеет поворота.

Параметры

Имя Тип Описание
left Number Новое положение по горизонтали, которое нужно установить, в пунктах.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

setLinkSlide(slideIndex)

Устанавливает Link на данный Slide , используя отсчитываемый от нуля индекс слайда.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Параметры

Имя Тип Описание
slideIndex Integer Отсчитываемый от нуля индекс слайда.

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

Link — Link , которая была установлена

Авторизация

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

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

setLinkSlide(slide)

Устанавливает Link на данный Slide , ссылка устанавливается по заданному идентификатору слайда.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Параметры

Имя Тип Описание
slide Slide Slide который нужно связать.

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

Link — Link , которая была установлена

Авторизация

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

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

setLinkSlide(slidePosition)

Устанавливает Link на данный Slide , используя относительное положение слайда.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Параметры

Имя Тип Описание
slidePosition SlidePosition Относительное значение SlidePosition .

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

Link — Link , которая была установлена

Авторизация

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

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

setLinkUrl(url)

Устанавливает Link на заданную непустую строку URL.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Параметры

Имя Тип Описание
url String Строка URL.

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

Link — Link , которая была установлена

Авторизация

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

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

setRotation(angle)

Задает угол поворота элемента по часовой стрелке вокруг его центра в градусах.

Этот метод не совместим со всеми элементами страницы. Чтобы узнать, какие элементы страницы несовместимы с этим методом, ознакомьтесь с ограничениями по размеру и расположению .

Параметры

Имя Тип Описание
angle Number Новый устанавливаемый угол поворота по часовой стрелке в градусах.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

setTitle(title)

Устанавливает заголовок альтернативного текста элемента страницы.

Метод не поддерживается для элементов Group .

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Параметры

Имя Тип Описание
title String Строка для установки заголовка альтернативного текста.

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

Image — этот элемент страницы.

Авторизация

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

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

setTop(top)

Задает положение элемента по вертикали в пунктах, измеряемое от левого верхнего угла страницы, когда элемент не имеет поворота.

Параметры

Имя Тип Описание
top Number Новое положение по вертикали, которое нужно установить, в пунктах.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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

setTransform(transform)

Задает преобразование элемента страницы с предоставленным преобразованием.

Обновление преобразования группы изменяет абсолютное преобразование элементов страницы в этой группе, что может изменить их внешний вид.

Обновление преобразования элемента страницы, который находится в группе, изменяет только преобразование этого элемента страницы; это не влияет на преобразования группы или других элементов страницы в группе.

Подробнее о том, как преобразования влияют на внешний вид элементов страницы, см. в getTransform() .

Параметры

Имя Тип Описание
transform AffineTransform Преобразование, заданное для этого элемента страницы.

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

Image — этот элемент для цепочки.

Авторизация

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

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

setWidth(width)

Устанавливает ширину элемента в пунктах, которая является шириной ограничивающей рамки элемента, когда элемент не имеет поворота.

Этот метод не совместим со всеми элементами страницы. Чтобы узнать, какие элементы страницы несовместимы с этим методом, ознакомьтесь с ограничениями по размеру и расположению .

Параметры

Имя Тип Описание
width Number Новая ширина этого элемента страницы для установки в пунктах.

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

Image — этот элемент страницы для цепочки.

Авторизация

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

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