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

86 lines
4.0 KiB
Markdown

---
title: "ksGetSpcObjForGeomWithLimit - Получить указатель на объект спецификации, подключенный к данному графическому объекту с ограничениями по номеру раздела и типу атрибута"
type: guide
api: [api7]
tags: [guide, api7, ksgetspcobjforgeomwithlimit]
sources:
- 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("Это не макроэлемент");
}