---
title: "GetAttrValue - Получить значение атрибута"
type: guide
api: [api7]
tags: [guide, api7, getattrvalue]
sources:
  - getattrvalue.html
---

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


## GetAttrValue - Получить значение атрибута

Пример...
Замечание. Функция устарела, вместо нее использовать ksGetAttrValue.
Аналог данной функции при использовании Automation - метод ksAttributeObject::ksGetAttrValue.
Синтаксис:
```
int GetAttrValue (reference pAttr,
unsigned int rowNumb,
unsigned int columnNumb,
unsigned char *flagVisible,
void *value, unsigned int size);
Входные параметры:
pAttr    - указатель на атрибут,
rowNumb    - номер строки,
columnNumb    - номер колонки,
flagVisible    - указатель на массив флагов видимости ячеек строки,
size    - размер выделенной под value памяти.
Выходной параметр:
value    - указатель на область памяти, куда копируются значения.
Возвращаемое значение:
1    - в случае удачного завершения,
0    - в случае неудачи.
```
Примечание:
Тип данных, которые находятся в области памяти с указателем value, описывается структурой параметров ColumnInfo для каждой колонки атрибута.


## GetAttrValue, SetAttrValue, GetAttrRow, SetAttrRow - Пример использования

void GetAttrvalue_Example (void) {
// если у объекта есть атрибут с ключом key1 = 100 и паролем "str",
// то заменим содержимое атрибута
double x, y;
reference pObj;
int j;
char buf[MAX_TEXT_LENGTH];
char s[MAX_TEXT_LENGTH];
RequestInfo info;
memset(&info, 0, sizeof(info));
info.prompt = "Укажите объект";
j = Cursor(&info, &x, &y, 0, 0);
if (j) {
if (ExistObj(pObj = FindObj(x, y, MAXDOUBLE))){
LightObj(pObj, 1);
//создадим итератор для поиска по атрибутам объекта c ключами 1,10,100
reference iter = CreateAttrIterator(pObj, 0,0,0,0,0);
//встали на первый атрибут
reference attr = MoveAttrIterator(iter, 'F', 0);
if (attr) {
// получили данные для первой строки из таблицы атрибута
// если тип атрибута - STRING_ATTR_TYPE,то таблица атрибута будет состоять
// из 1 строки и 1 колонки, ячейка и строка в таблице атрибутов будет
// совпадать, поэтому в данном случае функции
// GetAttrRow и GetAttrValue будут работать одинаково
GetAttrRow (attr, 0, 0, &buf, sizeof(buf));
sprintf(s, "содержимое атрибута - %s",buf);
Message(s);
strcpy(buf, "дуга");
// изменили содержимое строки в таблице атрибута
// функции SetAttrRow и SetAttrValue в данном случае будут работать одинаково
SetAttrRow(attr, 0, 0, &buf, sizeof(buf), "str");
}
else Message("атрибут не найден");
LightObj(pObj, 0);
}
}
}; /* GetAttrValue */
