Class Shape

Форма

Page Element , представляющий собой универсальную фигуру, не имеющую более конкретной классификации. Включает текстовые поля, прямоугольники и другие предопределенные фигуры.

Методы

Метод Тип возвращаемого значения Краткое описание
align On Page(alignmentPosition) Shape Выравнивает элемент по указанному положению на странице.
bring Forward() Shape Перемещает элемент страницы на один элемент вперед по странице.
bring To Front() Shape Выводит элемент страницы на передний план страницы.
duplicate() Page Element Дублирует элемент страницы.
get Autofit() Autofit |null Возвращает значение параметра Autofit для подгонки текста под заданную фигуру.
get Border() Border Возвращает Border фигуры.
get Connection Sites() Connection Site[] Возвращает список Connection Site ) для элемента страницы или пустой список, если элемент страницы не содержит сайтов подключения.
get Content Alignment() Content Alignment Возвращает значение Content Alignment текста в фигуре.
get Description() String Возвращает описание альтернативного текста элемента страницы.
get Fill() Fill Возвращает Fill фигуры.
get Height() Number|null Получает высоту элемента в точках, которая равна высоте ограничивающего прямоугольника элемента, когда элемент не имеет поворота.
get Inherent Height() Number|null Возвращает собственную высоту элемента в пунктах.
get Inherent Width() Number|null Возвращает внутреннюю ширину элемента в пунктах.
get Left() Number Возвращает горизонтальное положение элемента в точках, измеренное от верхнего левого угла страницы, если элемент не имеет поворота.
get Link() Link |null Возвращает Link или null , если ссылки нет.
get Object Id() String Возвращает уникальный идентификатор данного объекта.
get Page Element Type() Page Element Type Возвращает тип элемента страницы, представленный в виде перечисления Page Element Type .
get Parent Group() Group |null Возвращает группу, к которой принадлежит данный элемент страницы, или null если элемент не входит в группу.
get Parent Page() Page Возвращает страницу, на которой находится данный элемент страницы.
get Parent Placeholder() Page Element |null Возвращает родительский элемент страницы для заполнителя.
get Placeholder Index() Integer|null Возвращает индекс заполнителя фигуры.
get Placeholder Type() Placeholder Type Возвращает тип заполнителя фигуры или Placeholder Type.NONE если фигура не является заполнителем.
get Rotation() Number Возвращает угол поворота элемента по часовой стрелке вокруг его центра в градусах, где ноль градусов означает отсутствие поворота.
get Shape Type() Shape Type Возвращает тип фигуры.
get Text() Text Range Возвращает текстовое содержимое фигуры.
get Title() String Возвращает альтернативный текст заголовка элемента страницы.
get Top() Number Получает вертикальное положение элемента в точках, измеренное от верхнего левого угла страницы, когда элемент не имеет поворота.
get Transform() Affine Transform Возвращает преобразование элемента страницы.
get Width() Number|null Возвращает ширину элемента в пунктах, которая соответствует ширине ограничивающего прямоугольника элемента, когда элемент не имеет поворота.
preconcatenate Transform(transform) Shape Добавляет предоставленное преобразование к существующему преобразованию элемента страницы.
remove() void Удаляет элемент страницы.
remove Link() void Удаляет Link .
replace With Image(blobSource) Image Заменяет эту фигуру изображением, предоставленным Blob Source .
replace With Image(blobSource, crop) Image Заменяет эту фигуру изображением, предоставленным Blob Source .
replace With Image(imageUrl) Image Заменяет эту фигуру изображением.
replace With Image(imageUrl, crop) Image Заменяет эту фигуру изображением.
replace With Sheets Chart(sourceChart) Sheets Chart Заменяет эту фигуру диаграммой из Google Таблиц.
replace With Sheets Chart As Image(sourceChart) Image Заменяет эту фигуру изображением диаграммы из Google Таблиц.
scale Height(ratio) Shape Изменяет высоту элемента в соответствии с заданным коэффициентом.
scale Width(ratio) Shape Изменяет ширину элемента в соответствии с заданным коэффициентом.
select() void Выделяет только Page Element в активной презентации и удаляет любое предыдущее выделение.
select(replace) void Выбирает Page Element в активной презентации.
send Backward() Shape Отбрасывает элемент страницы на один элемент назад по странице.
send To Back() Shape Отправляет элемент страницы в конец страницы.
set Content Alignment(contentAlignment) Shape Задает Content Alignment текста внутри фигуры.
set Description(description) Shape Задает альтернативный текст описания для элемента страницы.
set Height(height) Shape Задает высоту элемента в точках, которая соответствует высоте ограничивающего прямоугольника элемента, когда элемент не имеет поворота.
set Left(left) Shape Задает горизонтальное положение элемента в точках, измеряемое от верхнего левого угла страницы, когда элемент не имеет поворота.
set Link Slide(slideIndex) Link Устанавливает Link на указанный Slide , используя нулевой индекс слайда.
set Link Slide(slide) Link Устанавливает Link на указанный Slide ; ссылка задается по идентификатору слайда.
set Link Slide(slidePosition) Link Устанавливает Link на указанный Slide , используя относительное положение слайда.
set Link Url(url) Link Устанавливает Link на заданную непустую строку URL.
set Rotation(angle) Shape Задает угол поворота элемента по часовой стрелке вокруг его центра в градусах.
set Title(title) Shape Задает альтернативный текст заголовка элемента страницы.
set Top(top) Shape Задает вертикальное положение элемента в точках, измеряемое от верхнего левого угла страницы, когда элемент не имеет поворота.
set Transform(transform) Shape Задает преобразование элемента страницы с заданным параметром transform.
set Width(width) Shape Задает ширину элемента в пунктах, которая соответствует ширине ограничивающего прямоугольника элемента, когда элемент не имеет поворота.

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

align On Page(alignmentPosition)

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

Параметры

Имя Тип Описание
alignment Position Alignment Position Положение, по которому следует выравнивать этот элемент страницы.

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

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

bring Forward()

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

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

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

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

Авторизация

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

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

bring To Front()

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

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

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

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

Авторизация

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

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

duplicate()

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

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

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

Page Element — Новая копия этого элемента страницы.

Авторизация

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

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

get Autofit()

Возвращает значение Autofit для подгонки текста внутри данной фигуры. Если фигура не позволяет разместить текст, значение параметра будет null .

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

Autofit |null — Автоматическая подгонка текста внутри этой фигуры.

Авторизация

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

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

get Border()

Возвращает Border фигуры.

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

Border — Настройка границ этой фигуры.

Авторизация

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

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

get Connection Sites()

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

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

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

Авторизация

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

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

get Content Alignment()

Возвращает значение Content Alignment текста в фигуре.

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

Content Alignment — выравнивание текста внутри этой фигуры.

Авторизация

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

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

get Description()

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

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

String — альтернативный текст описания элемента страницы.

Авторизация

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

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

get Fill()

Возвращает Fill фигуры.

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

Fill — параметр заливки этой фигуры.

Авторизация

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

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

get Height()

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

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

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

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

Авторизация

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

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

get Inherent Height()

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

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

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

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

Авторизация

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

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

get Inherent Width()

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

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

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

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

Авторизация

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

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

get Left()

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

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

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

Авторизация

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

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

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

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

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

Link |null — Link или null , если ссылки нет.

Авторизация

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

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

get Object Id()

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

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

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

Авторизация

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

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

get Page Element Type()

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

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

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

Авторизация

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

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

get Parent Group()

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

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

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

Авторизация

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

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

get Parent Page()

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

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

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

Авторизация

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

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

get Parent Placeholder()

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

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

Page Element |null — Родительский элемент страницы для этого заполнителя фигуры, или null если эта фигура не является заполнителем или не имеет родителя.

Авторизация

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

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

get Placeholder Index()

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

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

Integer|null — Индекс заполнителя этой фигуры или null , если фигура не является заполнителем.

Авторизация

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

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

get Placeholder Type()

Возвращает тип заполнителя фигуры или Placeholder Type.NONE если фигура не является заполнителем.

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

Placeholder Type — Тип заполнителя для этой фигуры.

Авторизация

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

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

get Rotation()

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

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

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

Авторизация

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

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

get Shape Type()

Возвращает тип фигуры.

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

Shape Type — Тип данной формы.

get Text()

Возвращает текстовое содержимое фигуры.

Текст внутри фигуры всегда заканчивается символом новой строки.

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

Text Range — текстовое содержимое этой фигуры.

Авторизация

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

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

get Title()

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

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

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

Авторизация

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

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

get Top()

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

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

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

Авторизация

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

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

get Transform()

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

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

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

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

Авторизация

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

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

get Width()

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

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

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

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

Авторизация

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

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

preconcatenate Transform(transform)

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

newTransform = argument * existingTransform;

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

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

Вы также можете заменить свойство transform элемента страницы с помощью set Transform(transform) .

Параметры

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

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

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

Авторизация

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

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

remove()

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

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

Если Page Element заполнитель удаляется в главном шаблоне или макете, то все пустые наследующие элементы-заполнители также удаляются.

Авторизация

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

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

Удаляет Link .

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

replace With Image(blobSource)

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

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

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

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
shape.replaceWithImage(driveImage);

Параметры

Имя Тип Описание
blob Source Blob Source Данные изображения.

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

Image — Image , заменившее форму.

Авторизация

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

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

replace With Image(blobSource, crop)

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

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

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

Параметры

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

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

Image — Image , заменившее форму.

Авторизация

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

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

replace With Image(imageUrl)

Заменяет эту фигуру изображением.

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

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

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

Параметры

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

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

Image — Image , заменившее форму.

Авторизация

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

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

replace With Image(imageUrl, crop)

Заменяет эту фигуру изображением.

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

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

Параметры

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

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

Image — Image , заменившее форму.

Авторизация

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

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

replace With Sheets Chart(sourceChart)

Заменяет эту фигуру диаграммой из Google Таблиц.

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

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

Параметры

Имя Тип Описание
source Chart Embedded Chart Диаграмма в электронной таблице, заменяющая фигуру.

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

Sheets Chart — диаграммы, заменившие геометрические фигуры.

Авторизация

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

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

replace With Sheets Chart As Image(sourceChart)

Заменяет эту фигуру изображением диаграммы из Google Таблиц.

Для сохранения пропорций диаграммы в Google Sheets изображение диаграммы масштабируется и центрируется относительно размера существующей фигуры.

Изображение диаграммы не связано с исходной диаграммой Google Sheets.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

Параметры

Имя Тип Описание
source Chart Embedded Chart Диаграмма в электронной таблице, заменяющая фигуру.

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

Image — изображение диаграммы, заменившей фигуру.

Авторизация

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

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

scale Height(ratio)

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

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

Параметры

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

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

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

Авторизация

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

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

scale Width(ratio)

Изменяет ширину элемента в соответствии с заданным коэффициентом. Ширина элемента равна ширине его ограничивающего прямоугольника, если элемент не имеет поворота.

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

Параметры

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

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

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

Авторизация

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

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

select()

Выбирает только Page Element в активном представлении и удаляет любой предыдущий выбор. Это эквивалентно вызову select(replace) с true .

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

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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)

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

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

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

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

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

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

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

const 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.
const pageElements = slide.getPageElements();
for (let 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

send Backward()

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

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

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

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

Авторизация

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

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

send To Back()

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

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

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

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

Авторизация

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

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

set Content Alignment(contentAlignment)

Задает Content Alignment текста внутри фигуры.

Этот метод автоматически отключает функцию автоматической подгонки текста к обновленным фигурам.

Параметры

Имя Тип Описание
content Alignment Content Alignment Выравнивание, которое необходимо установить.

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

Shape — Эта форма предназначена для соединения в цепочку.

Авторизация

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

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

set Description(description)

Задает альтернативный текст описания для элемента страницы.

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

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

Параметры

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

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

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

Авторизация

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

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

set Height(height)

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

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

Параметры

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

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

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

Авторизация

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

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

set Left(left)

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

Параметры

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

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

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

Авторизация

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

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

set Link Slide(slideIndex)

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

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

Параметры

Имя Тип Описание
slide Index Integer Индекс слайда, начинающийся с нуля.

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

Link — установленная Link .

Авторизация

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

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

set Link Slide(slide)

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

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

Параметры

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

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

Link — установленная Link .

Авторизация

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

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

set Link Slide(slidePosition)

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

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Параметры

Имя Тип Описание
slide Position Slide Position Относительное Slide Position .

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

Link — установленная Link .

Авторизация

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

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

set Link Url(url)

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

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

Параметры

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

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

Link — установленная Link .

Авторизация

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

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

set Rotation(angle)

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

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

Параметры

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

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

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

Авторизация

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

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

set Title(title)

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

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

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

Параметры

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

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

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

Авторизация

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

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

set Top(top)

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

Параметры

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

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

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

Авторизация

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

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

set Transform(transform)

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

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

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

Подробную информацию о том, как преобразования влияют на визуальное оформление элементов страницы, см. в разделе get Transform() .

Параметры

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

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

Shape — Этот элемент используется для создания цепочек.

Авторизация

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

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

set Width(width)

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

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

Параметры

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

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

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

Авторизация

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

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