---
title: "ksGetDimensionVariableName - Получить имя параметрической переменной, связанной с размером"
type: guide
api: [api7]
tags: [guide, api7, ksgetdimensionvariablename]
sources:
  - ksgetdimensionvariablename.html
---

*API экспортных функций > Функции работы с графическим документом  > Функции работы с параметрическими переменными и связями  > Функции параметризации и ограничений *


## ksGetDimensionVariableName - Получить имя параметрической переменной, связанной с размером

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksGetDimensionVariableName.
Синтаксис:
```
int ksGetDimensionVariableName (reference dimObj,
char * varName,
int size);
Входной параметр:
dimObj    - указатель на размер.
Выходной параметр:
varName    - имя переменной, если размеру поставлена в соответствие переменная,
size    - размер буфера, выделенного под имя переменной,
пустая строка    - если размеру не поставлена в соответствие переменная или в случае неудачи.
Возвращаемое значение:
1    - в случае успеха,
0    - в случае неудачи.
```


## ksGetDimensionVariableName - пример использования

reference iter = ::CreateIterator(LDIMENSION_OBJ, 0); // создаем итератор по линейным размерам
if (iter) {
reference obj = ::MoveIterator(iter, 'F'); // первый объект
char buf[128]; // буфер для имени переменной
while (::ExistObj(obj)) { // размер существует
if (::ksGetDimensionVariableName(obj, buf, 128)) // получим имя параметрической переменной размера
::Message(buf); // выведем имя переменнной
else // у размера нет переменной
::Message("Размер не имеет переменной"); // сообщение
obj = ::MoveIterator(iter, 'N'); // следующий объект
}
::DeleteIterator(iter); // удалим итератор