Эта страница переведена с помощью Cloud Translation API.

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 ElementType`	Возвращает тип элемента страницы, представленный в виде перечисления `Page ElementType` .
`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 ElementType .

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

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

Авторизация

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

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 должны быть выполнены следующие условия:

Родительская Page объекта Page Element должна быть current page selection .
Не должно быть выбрано несколько объектов 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