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». Однако предполагается, что часть имени файла, следующая за последней точкой (если таковая имеется), является существующим расширением, которое следует заменить. Следовательно, «Список покупок.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
— данные изображения в виде blob.
getBorder()
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
getLink()
Возвращает Link
или null
, если ссылки нет.
var link = shape.getLink(); if (link != null) { Logger.log('Shape has a link of type: ' + link.getLinkType()); }
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
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
removeLink()
Удаляет 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
должны быть выполнены следующие условия:
- Родительская
Page
объектаPageElement
должна бытьcurrent page selection
. - Не должно быть выбрано несколько объектов
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 | Индекс слайда, начинающийся с нуля. |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
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 , на который будет сделана ссылка. |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
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 . |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
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-адреса. |
Возвращаться
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
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