Files
kompas3d-mcp/docs/Kompas3D_SDK/structures/ksgetqualitycontensparam.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

5.4 KiB

title, type, api, tags, sources
title type api tags sources
ksGetQualityContensParam - Получить параметры квалитета struct
api7
struct
api7
ksgetqualitycontensparam
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, &param, 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, &param, 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; } } }