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