---
title: "ksSpcChangeValue - Изменить значение компонента с указанным номером в указанной колонке"
type: guide
api: [api7]
domain: [assembly]
tags: [guide, api7, assembly, ksspcchangevalue]
sources:
  - ksspcchangevalue.html
---

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

Пример...
Аналог данной функции при использовании Automation - метод ksSpecification::ksSpcChangeValue.
Синтаксис:
```
int ksSpcChangeValue (unsigned int colNumb,
unsigned int itemNumb,
void *val,
unsigned char typeVal);
Входные параметры:
colNumb    - номер колонки, начиная с единицы,
itemNumb    - номер компоненты, начиная с единицы,
val    - указатель на значение,
typeVal    - тип данных.
Типы данных...
Возвращаемое значение:
1    - в случае удачного завершения,
0    - в случае неудачи.- в случае неудачи.
```
Описание:
Функция позволяет изменить значение компонента с номером itemNumb в колонке с номером colNumb.
Если в колонке содержатся данные типа Запись, она может содержать несколько компонентов. При этом itemNumb может быть не равен 1.
Значение параметра typeVal - может лежать в интервале CHAR_ATTR_TYPE ...STRING_ATTR_TYPE (см. ltdefine.h). Если typeVal== STRING_ATTR_TYPE, то val - строка char[MAX_TEXT_LENGTH].
Функция работает в режиме создания нового или редактирования существующего объекта спецификации ksSpcObjectCreate; или ksSpcObjectEdit;
.....
ksSpcChangeValue();
.....
reference spsObj = ksSpcObjectEnd();
Примечание.
При использовании Unicode следует использовать функцию ksSpcChangeValueW.
