mikhail
e1337e4016
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>
81 lines
3.6 KiB
Markdown
81 lines
3.6 KiB
Markdown
---
|
|
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 */
|