---
title: "ksCopyObjEx - Копировать объект"
type: guide
api: [api7]
domain: [drawing]
tags: [guide, api7, drawing, kscopyobjex]
sources:
  - kscopyobjex.html
---

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

Аналог данной функции при использовании Automation - метод ksDocument2D::ksCopyObjEx.
Синтаксис:
```
reference ksCopyObjEx( CopyObjectParam * param );
Входные параметры:
param    - указатель на структуру параметров CopyObjectParam.
Возвращаемое значение:
указатель на объект или группу объектов    - в случае успешного завершения,
0    - в случае неудачи.
```
Примечание:
1. Функция позволяет копировать объект (объект вида, вид, группу, слой) в новую точку с возможностью задания масштабирования копии и поворота ее вокруг базовой точки.
2. При копировании одиночного объекта новый объект создается на текущем слое текущего вида.
3. При копировании группы объектов слой сохраняется.
4. При копировании одиночного многослойного макрообъекта он перестает быть многослойным. Макро и входящие в него объекты переносятся на текущий слой. Для копирования многослойного макро с сохранением многослойности требуется добавить его в группу.
