Files
kompas3d-mcp/docs/Kompas3D_SDK/structures/kssetmacroparamw.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

41 lines
3.6 KiB
Markdown

---
title: "ksSetMacroParamW - Записать параметры макроэлемента (Unicode)"
type: struct
api: [api7]
tags: [struct, api7, kssetmacroparamw]
sources:
- kssetmacroparamw.html
---
*API экспортных функций > Функции работы с графическим документом  > Создание графических объектов  > Работа с макроэлементами и библиотечными макроэлементами  > Функции работы с макроэлементами и библиотечными макроэлементами *
Аналог данной функции при использовании Automation - метод ksDocument2D::ksSetMacroParam.
Синтаксис:
```
extern "C" int LIB_FUNC ksSetMacroParamW( reference m,
void * value,
unsigned int size,
LPWSTR fileName,
LPWSTR libName,
int number,
unsigned char paramType );
Входные параметры:
m - указатель на макроэлемент,
value - указатель на структуру, содержащую сохраняемые параметры;
size - размер структуры параметров редактирования;
fileName - имя файла библиотеки;
libName - имя библиотеки;
number - номер функции в библиотеке,
paramType - битовый флаг, указание какой тип редактирования поддерживает макро.
Возвращаемое значение:
1 - в случае успешного завершения,
0 - в случае неудачи.
```
Описание:
Запись в макроэлемент параметров, создающей его библиотечной функции, для дальнейшего редактирования. Если в сеансе работы системы КОМПАС-ГРАФИК такой макроэлемент указывается двойным щелчком левой кнопки мыши, то автоматически будет вызвана библиотечная функция для его редактирования. Она не обязательно должна совпадать с родительской функцией. При значении имен библиотеки и ее файла NULL и номера функции -1 редактирование будет осуществляться родительской функцией.
При обработке событий это правило не действует, и в макроэлемент прописываются имя той библиотеки и ее файла, которая была использована непосредственно перед этим событием. Поэтому при создании макроэлемента по событию необходимо явно задавать имя библиотеки, имя файла и номер функции.
Примечание.
1. При использовании ANSI следует использовать функцию ksSetMacroParam.
2. Можно сохранить в макроэлементе дополнительные параметры, распределив блок памяти userPars и заполнив его нужными значениями (допустимы все типы данных, кроме указателей).
3. Параметры макроэлемента можно получить, используя функцию GetMacroParam.