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

Описания RDS

Приложения

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

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

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

А.5.25.32. Команда RDS_HVAR_SETVARFLAGS – одновременно установить все флаги переменной

# Приложения

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

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

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

##### А.5.25.32. Команда RDS_HVAR_SETVARFLAGS – одновременно установить все флаги переменной

Команда RDS_HVAR_SETVARFLAGS устанавливает флаги переменной с указанным номером в указанном объекте-редакторе.

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

      int iNum= … 	// Номер переменной
      int iFlags= …	// Набор флагов RDS_VARFLAG_*
      rdsSetObjectInt(Vars,RDS_HVAR_SETVARFLAGS,iNum,iFlags);

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

Vars(RDS_HOBJECT)
  Идентификатор вспомогательного объекта-редактора переменных, ранее созданного функцией rdsVSCreateEditor.
iNum(int)
  Целое число – номер переменной в объекте Vars.
iFlags(int)
  Целое число – набор битовых флагов RDS_VARFLAG_* (см. поле Flags структуры RDS_VARDESCRIPTION) для переменной с номером iNum в объекте Vars.

Примечания

Эта команда, как и функция rdsVSSetVarFlags, устанавливает битовые флаги переменной с номером iNum. В отличие от rdsVSSetVarFlags, команда не позволяет изменить только часть флагов. В параметрах команды не предусмотрена маска установки, поэтому переменная получает все флаги из параметра iFlags: единичные биты в параметре взведут соответствующие флаги, нулевые – сбросят. Фактически, вызов

      rdsSetObjectInt(Vars,RDS_HVAR_SETVARFLAGS,iNum,iFlags);

полностью эквивалентен вызову функции

      rdsVSSetVarFlags(Vars,iNum,iFlags,0xFFFFFFFF);

См. также

rdsVSCreateEditor, rdsSetObjectInt, rdsVSSetVarFlags, rdsVSAddVar.