Приложения
Приложение А. Функции, константы и структуры 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.
См. также