ksGetAttrValue - Получить значение ячейки из таблицы атрибута |
Scroll |
Аналог данной функции при использовании Automation - метод ksAttributeObject::ksGetAttrValue.
Синтаксис:
int ksGetAttrValue (reference pAttr,
unsigned int rowNumb,
unsigned int columnNumb,
unsigned char *flagVisible,
unsigned char *columnKeys,
void *value,
unsigned int size);
Входные параметры:
pAttr |
- указатель на атрибут, |
rowNumb |
- номер строки, |
columnNumb |
- номер колонки, |
size |
- размер выделенной под value памяти. |
Выходной параметр:
value |
- указатель на область памяти, куда копируются значения, |
flagVisible |
- указатель на массив флагов видимости ячеек строки, |
columnKeys |
- указатель на массив ключей ячеек строки. |
Возвращаемое значение:
1 |
- в случае удачного завершения, |
0 |
- в случае неудачи. |
Примечание:
1. Для нетабличного атрибута номер колонки равен нулю.
2. Указатель на атрибут reference pAttr может быть получен следующими способами:
– с помощью функций итератора CreateAttrIterator, MoveAttrIterator,
– с помощью функций создания атрибутов ksCreateAttr или выбора атрибутов ChoiceAttr.
3. Для получения размера данных ячейки атрибута может быть использована функция ksGetSizeAttrValue.
4. Перед использованием указателей value, flagVisible, columnKeys для каждого указателя должен быть выделен буфер памяти, и его адрес присвоен соответствующей переменной.
5. При использовании Unicode следует использовать функцию ksGetAttrValueW.
6. Тип данных, которые находятся в области памяти с указателем value, описывается структурой параметров ColumnInfo для каждой колонки атрибута.
Подразделы:
(отсутствуют)