Files
kompas3d-mcp/docs/Kompas3D_SDK/structures/setmacroparam.md
T
mikhail e1337e4016 feat(sdk-docs): MD-база знаний SDK — в репозиторий; генератор и зеркало убраны
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>
2026-05-26 20:00:05 +03:00

3.9 KiB

title, type, api, tags, sources
title type api tags sources
SetMacroParam - Установить параметры макроэлемента struct
api7
struct
api7
setmacroparam
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); };