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

56 lines
2.8 KiB
Markdown

---
title: "ksGetQualityNames - Получить массив полей допусков, которые поддерживают размер dimValue и не превышают указанных отклонений"
type: guide
api: [api7]
tags: [guide, api7, ksgetqualitynames]
sources:
- ksgetqualitynames.html
---
*API экспортных функций > Функции работы с графическим документом  > Работа с видами  > Функции работы с видами *
## ksGetQualityNames - Получить массив полей допусков, которые поддерживают размер dimValue и не превышают указанных отклонений
Пример...
Аналог данной функции при использовании Automation - метод KompasObject::ksGetQualityNames.
Синтаксис:
```
int ksGetQualityNames (reference names,
double dimValue,
double high,
double low,
unsigned char system,
unsigned char withLimitation);
Входные параметры:
names - указатель на динамический массив полей допусков,
dimValue - номинальное значение размера (в мм),
high - верхнее отклонение,
low - нижнее отклонение,
system - система: 1 - отверстия, 0 - вала.
withLimitation - признак учета ограничений: 0 - без учёта ограничений, 1 - с учётом ограничений, наложенных в системе.
Возвращаемое значение:
1 - в случае удачного завершения,
0 - в случае неудачи.
```
## ksGetQualityNames - Пример использования
reference names = ::CreateArray(CHAR_STR_ARR, 0); // динамический массив строк
// получить поля допусков для размера 139 мм, верхнее отклонение 0.16 мм,
// нижнее - 0 мм, система отверстия, с учётом ограничений
if (::ksGetQualityNames(names, 139, 0.16, 0, 1/*system*/, 1/*withLimitation*/)) {
string s(""); // строка сообщения
int count = ::GetArrayCount(names); // кол-во элементов в массиве
for (int i = 0; i < count; i++) { // пройдём по всему массиву
char item[255]; // буфер
if (::GetArrayItem(names, i, item, 255)) { // взять текущую строку из массива
s += item; // добавить её к сообщению
s += " "; // разделитель
}
} // выводим сообщение
::Message((char*)s.c_str()); // удалить массив
::DeleteArray(names);
}