Текущий раздел:

Описания RDS

Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.25. Вспомогательный объект для изменения структуры переменных блока

А.5.25.21. Команда RDS_HVAR_DELVAR – удалить переменную

# Приложения

## Приложение А. Функции, константы и структуры RDS

### А.5. Сервисные функции и макросы RDS

#### А.5.25. Вспомогательный объект для изменения структуры переменных блока

##### А.5.25.21. Команда RDS_HVAR_DELVAR – удалить переменную

Команда RDS_HVAR_DELVAR удаляет из указанного объекта-редактора переменную с заданным номером.

Вызов команды

      int iNum= … // Номер удаляемой переменной
      BOOL bOk=rdsCommandObjectEx(Vars,RDS_HVAR_DELVAR,iNum,NULL);

Параметры и результат

Vars(RDS_HOBJECT)
  Идентификатор вспомогательного объекта-редактора переменных, ранее созданного функцией rdsVSCreateEditor.
iNum(int)
  Целое число – номер удаляемой переменной.
bOk(BOOL)
  Логический результат выполнения команды: TRUE – переменная удалена, FALSE – в объекте Vars нет переменной с номером iNum.

Примечания

Переменная из объекта удаляется по номеру, номер переменной указывается при ее создании функциями rdsVSAddVar, rdsVSAddVarByDescr и rdsVSAddVarByTypeText. При создании сразу всего набора переменных переменных функциями rdsVSCreateByDescr и rdsVSCreateFromBlock переменные получают последовательные номера.

После удаления все переменные с номерами, большими iNum, сдвигаются вверх на единицу: переменная с номером iNum+1 становится получает номер iNum, переменная с номером iNum+2 получает номер iNum+1 и т.д.

Общее число переменных можно узнать при помощи команды RDS_HVAR_GETFIELDCOUNT.

См. также

rdsVSCreateEditor, RDS_HVAR_GETFIELDCOUNT.