---
title: "StoreTmpGroup - Вставить временную группу в документ (группа \"рассыпается\")"
type: guide
api: [api7]
tags: [guide, api7, storetmpgroup]
sources:
  - storetmpgroup.html
---

*API экспортных функций > Функции работы с графическим документом  > Работа с группами объектов  > Функции работы с группами объектов *


## StoreTmpGroup - Вставить временную группу в документ (группа "рассыпается")

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksStoreTmpGroup.
Синтаксис:
```
int StoreTmpGroup (reference g);
Входной параметр:
g    - указатель на группу.
Возвращаемое значение:
1    - в случае успешного завершения,
0    - в случае неудачи.
```
Примечание:
Временные объекты не записываются в документ и на экране не отображаются. Они сохраняются только до конца работы создающей их библиотечной команды. Временная группа чаще всего служит для отрисовки фантомного изображения и используется в качестве параметров в функциях Placement и Cursor. Функция StoreTmpGroup записывает все объекты временной группы в модель (т.е. фиксирует ее). Сама же группа получает статус постоянной.


## StoreTmpGroup- Пример использования

void StoreTmpGroup_Example (void) {
reference gr ;
gr = NewGroup(1); /* задание группы объектов */
LineSeg (-15, 0, 15, 0, 3); /* объекты записываются */
LineSeg ( 0, -15, 0, 15, 3); /* во временный список */
Circle (0, 0, 10, 1);
EndGroup(); /* закончить формирование группы */
if (Yes_No(Фиксируем группу?)) {
StoreTmpGroup(gr);
}; /* StoreTmpGroup*/