mikhail
e1337e4016
docs/Kompas3D_SDK/ становится каноническим источником справки КОМПАС SDK и включается в репозиторий (2491 файл, ~14 МБ). HTML-зеркало docs/KOMPAS_SDK_ru-RU/ (~1.4 ГБ, © АСКОН) и генератор tools/build_kompas3d_sdk.py больше не нужны — регенерация не предполагается. - .gitignore: MD-база разблокирована; зеркало остаётся проигнорированным (safety-net на случай повторной локальной выгрузки). - CLAUDE.md / SKILL.md: убраны упоминания регенерации и зеркала. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
76 lines
3.9 KiB
Markdown
76 lines
3.9 KiB
Markdown
---
|
|
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);
|
|
};
|