---
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);
}
