Class Group

Группа

Набор Page Element , объединенных в единое целое.

Методы

Метод Тип возвращаемого значения Краткое описание
align On Page(alignmentPosition) Group Выравнивает элемент по указанному положению на странице.
bring Forward() Group Перемещает элемент страницы на один элемент вперед по странице.
bring To Front() Group Выводит элемент страницы на передний план страницы.
duplicate() Page Element Дублирует элемент страницы.
get Children() Page Element[] Получает набор элементов страницы, входящих в группу.
get Connection Sites() Connection Site[] Возвращает список Connection Site ) для элемента страницы или пустой список, если элемент страницы не содержит сайтов подключения.
get Description() String Возвращает описание альтернативного текста элемента страницы.
get Height() Number|null Получает высоту элемента в точках, которая равна высоте ограничивающего прямоугольника элемента, когда элемент не имеет поворота.
get Inherent Height() Number|null Возвращает собственную высоту элемента в пунктах.
get Inherent Width() Number|null Возвращает внутреннюю ширину элемента в пунктах.
get Left() Number Возвращает горизонтальное положение элемента в точках, измеренное от верхнего левого угла страницы, если элемент не имеет поворота.
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 Rotation() Number Возвращает угол поворота элемента по часовой стрелке вокруг его центра в градусах, где ноль градусов означает отсутствие поворота.
get Title() String Возвращает альтернативный текст заголовка элемента страницы.
get Top() Number Получает вертикальное положение элемента в точках, измеренное от верхнего левого угла страницы, когда элемент не имеет поворота.
get Transform() Affine Transform Получает преобразование элемента страницы.
get Width() Number|null Возвращает ширину элемента в пунктах, которая соответствует ширине ограничивающего прямоугольника элемента, когда элемент не имеет поворота.
preconcatenate Transform(transform) Group Добавляет предоставленное преобразование к существующему преобразованию элемента страницы.
remove() void Удаляет элемент страницы.
scale Height(ratio) Group Изменяет высоту элемента в соответствии с заданным коэффициентом.
scale Width(ratio) Group Изменяет ширину элемента в соответствии с заданным коэффициентом.
select() void Выделяет только Page Element в активной презентации и удаляет любое предыдущее выделение.
select(replace) void Выбирает Page Element в активной презентации.
send Backward() Group Отбрасывает элемент страницы на один элемент назад по странице.
send To Back() Group Отправляет элемент страницы в конец страницы.
set Description(description) Group Задает альтернативный текст описания для элемента страницы.
set Height(height) Group Задает высоту элемента в точках, которая соответствует высоте ограничивающего прямоугольника элемента, когда элемент не имеет поворота.
set Left(left) Group Задает горизонтальное положение элемента в точках, измеряемое от верхнего левого угла страницы, когда элемент не имеет поворота.
set Rotation(angle) Group Задает угол поворота элемента по часовой стрелке вокруг его центра в градусах.
set Title(title) Group Задает альтернативный текст заголовка элемента страницы.
set Top(top) Group Задает вертикальное положение элемента в точках, измеряемое от верхнего левого угла страницы, когда элемент не имеет поворота.
set Transform(transform) Group Задает преобразование элемента страницы с заданным параметром transform.
set Width(width) Group Задает ширину элемента в пунктах, которая соответствует ширине ограничивающего прямоугольника элемента, когда элемент не имеет поворота.
ungroup() void Разгруппировывает элементы группы.

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

align On Page(alignmentPosition)

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

Параметры

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

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

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

bring Forward()

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

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

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

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

Авторизация

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

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

bring To Front()

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

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

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

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

Авторизация

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

  • 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 Children()

Получает набор элементов страницы, входящих в группу. Минимальный размер группы — 2.

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

Page Element[] — Список элементов страницы в этой группе.

Авторизация

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

  • 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 Description()

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

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

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

Авторизация

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

  • 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

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 Rotation()

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

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

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

Авторизация

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

  • 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()

Получает преобразование элемента страницы.

Начальное преобразование для вновь созданной Group всегда является единичным преобразованием: параметры масштабирования равны 1,0, а параметры сдвига и перемещения равны 0,0.

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

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 Преобразование, которое будет добавлено к преобразованию этого элемента страницы.

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

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

Авторизация

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

  • 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

scale Height(ratio)

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

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

Параметры

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

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

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

Авторизация

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

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

scale Width(ratio)

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

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

Параметры

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

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

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

Авторизация

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

  • 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()

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

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

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

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

Авторизация

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

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

send To Back()

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

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

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

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

Авторизация

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

  • 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 Строка, на которую будет установлен альтернативный текст описания.

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

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

Авторизация

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

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

set Height(height)

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

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

Параметры

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

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

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

Авторизация

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

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

set Left(left)

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

Параметры

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

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

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

Авторизация

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

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

set Rotation(angle)

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

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

Параметры

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

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

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

Авторизация

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

  • 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 Строка, которая задаёт альтернативный текст заголовка.

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

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

Авторизация

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

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

set Top(top)

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

Параметры

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

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

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

Авторизация

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

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

set Transform(transform)

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

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

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

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

Параметры

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

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

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

Авторизация

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

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

set Width(width)

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

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

Параметры

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

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

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

Авторизация

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

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

ungroup()

Разгруппировывает элементы группы.

Сама группа удалена.

Группы внутри других групп не могут быть разделены.

Авторизация

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

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