Приложения

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