---
title: "SetMacroParam - Установить параметры макроэлемента"
type: struct
api: [api7]
tags: [struct, api7, setmacroparam]
sources:
  - setmacroparam.html
---

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


## SetMacroParam - Установить параметры макроэлемента

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksSetMacroParam.
Синтаксис:
```
int SetMacroParam (reference m,
void * value,
unsigned int size,
char *fileName,
char * libName,
int number);
Входные параметры:
m    - указатель на макроэлемент,
value    - указатель на структуру, содержащую сохраняемые параметры;
size    - размер структуры параметров редактирования;
fileName    - имя файла библиотеки;
libName    - имя библиотеки;
number    - номер функции в библиотеке.
Возвращаемое значение:
1    - в случае успешного завершения,
0    - в случае неудачи.
```
Описание:
1. Запись в макроэлемент параметров, создающей его библиотечной функции, для дальнейшего редактирования. Если в сеансе работы системы КОМПАС-ГРАФИК такой макроэлемент указывается двойным щелчком левой кнопки мыши, то автоматически будет вызвана библиотечная функция для его редактирования. Она не обязательно должна совпадать с родительской функцией. При значении имен библиотеки и ее файла NULL и номера функции -1 редактирование будет осуществляться родительской функцией.
2. Можно сохранить в макроэлементе дополнительные параметры, распределив блок памяти userPars и заполнив его нужными значениями (допустимы все типы данных, кроме указателей).
3. Параметры макроэлемента можно получить, используя функцию GetMacroParam.
Примечание:
Функция устарела, рекомендуется вместо нее использовать функцию ksSetMacroParam.


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

// пример построения прямоугольника с последующим его редактированием
void DrawRect ()
{
struct
{
double a;
double b;
}
r;
if (EditMacroMode())
//режим редактирования
GetMacroParam (m, &r, sizeof (r));
else
//cоздание нового макроэлемента
{
r.a = 20;
r.b = 10;
}
ReadDouble ("задайте ширину",r.a,0,100, &r.a);
ReadDouble ("задайте высоту",r.b,0,100, &r.b);
Macro(); /* определение макроэлемента */
// Прямоугольник
LineSeg(0, 0, r.a, 0, 0);
LineSeg(r.a, 0, r.a, r.b, 0);
LineSeg(r.a, r.b, 0, r.b, 0);
LineSeg(0, r.b, 0, 0, 0);
reference m = EndObj();
//записать параметры в макроэлемент
SetMacroParam (m, &r, sizeof(r), NULL, NULL, -1);
};
