Приложения

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

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

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

А.5.25.16. rdsVSSetVarFlags – установить флаги переменной

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

  void RDSCALL rdsVSSetVarFlags(
    RDS_HOBJECT Vars,  // Редактор переменных
    int Index,         // Номер переменной
    DWORD Flags,       // Флаги
    DWORD Mask         // Маска
  );

Тип указателя на эту функцию

RDS_VHoIDwDw

Параметры

Vars (RDS_HOBJECT): Идентификатор вспомогательного объекта-редактора переменных, ранее созданного функцией rdsVSCreateEditor.
Index (int): Начинающийся с нуля номер переменной в объекте Vars.
Flags (DWORD): Набор битовых флагов переменной RDS_VARFLAG_* (см. поле Flags структуры RDS_VARDESCRIPTION).
Mask (DWORD): Маска изменяемых битовых флагов (единичные биты в позиции тех флагов, которые нужно изменить в переменной Index согласно Flags).

Примечания

Эта функция устанавливает и сбрасывает битовые флаги, определяющие поведение переменной с номером Index в объекте Vars. В параметре Flags передается целое число, у которого в позициях, соответствующих взводимым флагам, будут единичные биты, а в позициях, соответствующих сбрасываемым – нулевые. При этом в параметре Mask должно быть передано целое число, у которого единичные биты соответствуют изменяемым (взводимым или сбрасываемым) флагам, а нулевые – флагам, остающимся неизменными.

Пример

Пример использования функции rdsVSSetVarFlags приведен в §2.16.1 руководства программиста.

См. также

RDS_VARDESCRIPTION, rdsSetBlockVarFlags, RDS_HVAR_GETVARFLAGS.