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

Описания RDS

Приложения

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

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

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

А.5.28.14. Команда RDS_FORMVAL_CHECK – управление разрешающим флагом поля ввода

# Приложения

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

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

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

##### А.5.28.14. Команда RDS_FORMVAL_CHECK – управление разрешающим флагом поля ввода

Команда RDS_FORMVAL_CHECK служит для включения или выключения дополнительного разрешающего флага поля ввода, а также для получения значения этого флага. Команда выполняется, только если при создании поля ввода был указан флаг RDS_FORMFLAG_CHECK.

Вызов команды для установки

      int iCtrlId= … // Идентификатор поля ввода
      int iEnable= … // 1 – разрешить, 0 - запретить
      rdsSetObjectInt(Win,iCtrlId,RDS_FORMVAL_CHECK,iEnable);

или

      int iCtrlId= …    // Идентификатор поля ввода
      double dEnable= … // >0.0 – разрешить, <=0.0 - запретить
      rdsSetObjectDouble(Win,iCtrlId,RDS_FORMVAL_CHECK,dEnable);

Вызов команды для чтения

      int iCtrlId= … // Идентификатор поля ввода
      int iEnable=rdsGetObjectInt(Win,iCtrlId,RDS_FORMVAL_CHECK);

или

      int iCtrlId= … // Идентификатор поля ввода
      double dEnable=rdsGetObjectDouble(Win,iCtrlId,RDS_FORMVAL_CHECK);

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

Win(RDS_HOBJECT)
  Идентификатор вспомогательного объекта для работы с модальным окном, ранее созданного функцией rdsFORMCreate.
iCtrlId(int)
  Целый идентификатор поля ввода, присвоенный ему при вызове функции rdsFORMAddEdit.
iEnable(int)
  Целое число, указывающее на включение (отличное от нуля значение) или выключение (нулевое значение) разрешающего флага.
dEnable(double)
  Вещественное число, указывающее на включение (положительное значение) или выключение (нулевое или отрицательное значение) разрешающего флага.

Примечания

Эта команда управляет разрешающим флагом поля ввода. При включенном флаге поле будет разрешено и пользователь сможет вводить в него данные, при выключенном – запрещено и заблокировано (при этом оно обычно изображается серым цветом).

Для передачи команды полю ввода можно использовать как целые функции rdsSetObjectInt и rdsGetObjectInt, так и вещественные rdsSetObjectDouble и rdsGetObjectDouble. Чаще всего используются именно целые функции – принимаемое и возвращаемое ими целое число трактуется по обычным правилам языка C: нулевое значение считается логической ложью (флаг выключен, поле запрещено), все остальные – логической истиной (флаг включен, поле разрешено).

Не следует путать команду управления дополнительным флагом разрешения поля RDS_FORMVAL_CHECK с командой разрешения всего поля RDS_FORMVAL_ENABLED: первая включает и выключает дополнительный флаг, разрешая или запрещая поле (разрешенность самого флага при этом не меняется), а вторая разрешает или запрещает все поле целиком вместе с дополнительным флагом.

Пример

Пример использования команды RDS_FORMVAL_CHECK приведен в §2.15.3 руководства программиста.

См. также

RDS_FORMFLAG_CHECK, rdsFORMCreate, rdsFORMAddEdit, rdsSetObjectInt, rdsGetObjectInt, rdsSetObjectDouble, rdsGetObjectDouble, RDS_FORMVAL_ENABLED.