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 Получает высоту элемента в пунктах, которая является высотой ограничивающей рамки элемента, когда элемент не вращается.
get Inherent Height() Number Возвращает собственную высоту элемента в пунктах.
get Inherent Width() Number Возвращает собственную ширину элемента в пунктах.
get Left() Number Возвращает горизонтальное положение элемента в пунктах, измеренное от верхнего левого угла страницы, когда элемент не вращается.
get Object Id() String Возвращает уникальный идентификатор этого объекта.
get Page Element Type() Page Element Type Возвращает тип элемента страницы, представленный в виде перечисления Page Element Type .
get Parent Group() Group Возвращает группу, к которой принадлежит этот элемент страницы, или null если элемент не входит в группу.
get Parent Page() Page Возвращает страницу, на которой находится этот элемент страницы.
get Rotation() Number Возвращает угол поворота элемента по часовой стрелке вокруг его центра в градусах, где ноль градусов означает отсутствие вращения.
get Title() String Возвращает замещающий текстовый заголовок элемента страницы.
get Top() Number Получает вертикальное положение элемента в точках, измеренное от верхнего левого угла страницы, когда элемент не вращается.
get Transform() Affine Transform Получает преобразование элемента страницы.
get Width() Number Возвращает ширину элемента в пунктах, которая равна ширине ограничивающей рамки элемента, когда элемент не вращается.
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 Устанавливает преобразование элемента страницы с помощью предоставленного преобразования.
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 , если элемент страницы не имеет высоты.

Авторизация

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

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

get Inherent Height()

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

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

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

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

Авторизация

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

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

get Inherent Width()

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

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

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

Number — собственная ширина элемента страницы в пунктах или 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 .

Авторизация

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

  • 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 , если элемент страницы не имеет ширины.

Авторизация

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

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

Вы также можете заменить преобразование элемента страницы на 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)

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

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

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

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