Files
kompas3d-mcp/docs/Kompas3D_SDK/guides/ksgetspcobjforgeomwithlimit.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

4.0 KiB

title, type, api, tags, sources
title type api tags sources
ksGetSpcObjForGeomWithLimit - Получить указатель на объект спецификации, подключенный к данному графическому объекту с ограничениями по номеру раздела и типу атрибута guide
api7
guide
api7
ksgetspcobjforgeomwithlimit
ksgetspcobjforgeomwithlimit.html

*API экспортных функций > Функции работы с документом-спецификацией *

ksGetSpcObjForGeomWithLimit - Получить указатель на объект спецификации, подключенный к данному графическому объекту с ограничениями по номеру раздела и типу атрибута

Пример... Аналог данной функции при использовании Automation - метод ksSpecification::ksGetSpcObjForGeomWithLimit. Синтаксис:

reference ksGetSpcObjForGeomWithLimit (char * nameLib,
unsigned int numb,
reference obj,
unsigned char equal,
unsigned char first,
unsigned short section,
double attrTypeNumb);
Входные параметры:
nameLib    - имя библиотеки стилей спецификации,
numb    - номер стиля спецификации в библиотеке,
obj    - указатель на графический объект или группу объектов (если obj = 0, функция работает с макроэлементом редактирования),
equal    - признак вхождения геометрии в состав объекта: 1 - геометрия идентична геометрии объекта спецификации, 0 - геометрия входит в объект спецификации,
first    - 1 - первый объект, 0 - следующий объект
section    - номер раздела, в котором нужно найти объект (0 - номер не ограничивается),
attrTypeNumb    - номер типа атрибута, для которого нужно найти объект (0 - номер не ограничивается).
Возвращаемое значение:
- указатель на объект спецификации.

Примечания:

  1. Данный метод - только для графических документов.
  2. В настоящий момент метод реализован только для equal = 1.
  3. При использовании Unicode следует использовать функцию ksGetSpcObjForGeomWithLimitW.

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

reference pObj; RequestInfo info; double x, y; memset (&info, 0, sizeof(info)); info.prompt = "Укажите макроэлемент болт"; reference g; int j = Cursor (&info, &x ,&y, 0); if (j) { if (ExistObj(pObj = FindObj(x, y, 1e6)) && GetObjParam(pObj, 0, 0, 0) == MACRO_OBJ ) { //найдем объект спецификации по заданной геометрии reference spcObj = ::ksGetSpcObjForGeomWithLimit ("graphic.lyt", //имя //библиотеки стилей 1, //номер //стиля спецификации pObj , 0, //присланная //геометрия входит // в объект спецификации 1, //-первый объект 25, //номер раздела 313277777065.0); if (spcObj) { char buf[TEXT_LENGTH]; //получим наименование объекта спецификации ksGetSpcObjectColumnText (spcObj, //объект спецификации SPC_CLM_NAME , //тип колонки 1, //номер колонки данного типа 1, //номер блока buf, //указатель TEXT_LENGTH); //длина строки s Message(buf); } else Error("Это не объект спецификации Болт"); } else Error("Это не макроэлемент"); }