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>
101 lines
5.4 KiB
Markdown
101 lines
5.4 KiB
Markdown
---
|
|
title: "ksGetQualityContensParam - Получить параметры квалитета"
|
|
type: struct
|
|
api: [api7]
|
|
tags: [struct, api7, ksgetqualitycontensparam]
|
|
sources:
|
|
- ksgetqualitycontensparam.html
|
|
---
|
|
|
|
*API экспортных функций > Функции работы с графическим документом > Размеры и технологические обозначения > Функции построения размеров /обозначений *
|
|
|
|
|
|
## ksGetQualityContensParam - Получить параметры квалитета
|
|
|
|
Пример...
|
|
Аналог данной функции при использовании Automation - метод KompasObject::ksGetQualityContensParam.
|
|
Синтаксис:
|
|
```
|
|
int ksGetQualityContensParam (const char* name,
|
|
QualityContensParam* param,
|
|
unsigned char inMM);
|
|
Входные параметры:
|
|
inMM - размерность параметров minLimit, maxLimit, high, low: 1 - миллиметры, 0 - единицы измерения текущего документа.
|
|
Выходной параметр:
|
|
param - указатель на структуру параметров квалитета QualityContensParam.
|
|
name - поле допуска.
|
|
Возвращаемое значение:
|
|
1 - в случае удачного завершения,
|
|
0 - в случае неудачи.
|
|
Примечание.
|
|
При использовании Unicode следует использовать функцию ksGetQualityContensParamW.
|
|
```
|
|
|
|
|
|
## ksGetQualityContensParam - Пример использования
|
|
|
|
char name[20]; // поле допуска
|
|
::strcpy(name, "H7"); // умолчательное значение
|
|
if (ReadString("Укажите поле допуска", name, 4)) { // запрос поля допуска у пользователя
|
|
char buf[255]; // буфер
|
|
string s(""); // строка сообщения
|
|
if (!::strcmp(name, "")) { // пустая строка - идём итератором
|
|
// итератор по системе отверстия с учётом ограничений наложенных в системе
|
|
reference iter = ::ksCreateQualityIterator(1/*system*/, 1/*withLimitation*/);
|
|
if (iter) { // итератор создан
|
|
QualityContensParam param; // структура параметров квалитета
|
|
int first = 0; // начало чтения
|
|
// продолжаем чтение пока не считаем все квалитеты
|
|
while (::ksMoveQualityIterator(iter, ¶m, false/*inMM*/, !first ? 'F' : 'N')) {
|
|
::sprintf(buf, "Система %s, Тип квалитета %i, Поле допуска %s\n",
|
|
(param.systemQuality == 1 ? "Вала" : "Отверстия"), param.kindQuality,
|
|
param.name); // формируем строку для текущего квалитета
|
|
s += buf; // добавляем к сообщению
|
|
int count = ::GetArrayCount(param.pQualityItems); // кол-во интервалов
|
|
for (int i = 0; i < count; i++) { // проходим по всем интервалам
|
|
QualityItemParam item; // запись об одном интервале для какого-то квалитета
|
|
// считываем текущюю запись
|
|
if (::GetArrayItem(param.pQualityItems, i, &item, sizeof(QualityItemParam))) {
|
|
// выводим параметры интервала в строку
|
|
::sprintf(buf, "Значение: %i < X < %i, high = %g, low = %g\n",
|
|
item.minLimit, item.maxLimit, item.high, item.low);
|
|
s += buf; // добавляем к сообщению
|
|
}
|
|
}
|
|
::Message((char*)s.c_str()); // выводим сообщение
|
|
s = ""; // очищаем строку сообщения
|
|
::DeleteArray(param.pQualityItems); // удаляем массив интервалов
|
|
param.pQualityItems = 0;
|
|
if (!first) // пришли первый раз
|
|
first = 1; // взводим флаг
|
|
}
|
|
::DeleteIterator(iter); // удалить итератор
|
|
}
|
|
}
|
|
else { // имя есть
|
|
QualityContensParam param; // структура параметров квалитета
|
|
// считываем параметры указанного квалитета
|
|
if (::ksGetQualityContensParam(name, ¶m, false/*inMM*/)) {
|
|
::sprintf(buf, "Система %s, Тип квалитета %i, Поле допуска %s\n",
|
|
(param.systemQuality == 1 ? "Вала" : "Отверстия"), param.kindQuality,
|
|
param.name); // формируем строку для текущего квалитета
|
|
s += buf; // добавляем к сообщению
|
|
int count = ::GetArrayCount(param.pQualityItems); // кол-во интервалов
|
|
for (int i = 0; i < count; i++) { // проходим по всем интервалам
|
|
QualityItemParam item; // запись об одном интервале для какого-то квалитета
|
|
// считываем текущюю запись
|
|
if (::GetArrayItem(param.pQualityItems, i, &item, sizeof(QualityItemParam))) {
|
|
// выводим параметры интервала в строку
|
|
::sprintf(buf, "Значение: %i < X < %i, high = %g, low = %g\n",
|
|
item.minLimit, item.maxLimit, item.high, item.low);
|
|
s += buf; // добавляем к сообщению
|
|
}
|
|
}
|
|
::Message((char*)s.c_str()); // выводим сообщение
|
|
s = ""; // очищаем строку сообщения
|
|
::DeleteArray(param.pQualityItems); // удаляем массив интервалов
|
|
param.pQualityItems = 0;
|
|
}
|
|
}
|
|
}
|