Files
kompas3d-mcp/docs/Kompas3D_SDK/guides/getattrvalue.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

3.6 KiB

title, type, api, tags, sources
title type api tags sources
GetAttrValue - Получить значение атрибута guide
api7
guide
api7
getattrvalue
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 */