Приложения

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

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

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

А.5.28.23. Команда RDS_FORMVAL_RANGEMAX – значение поля ввода конца диапазона

Команда RDS_FORMVAL_RANGEMAX устанавливает или возвращает значение второго (правого) поля в двойном поле ввода RDS_FORMCTRL_RANGEEDIT, которое чаще всего используется для задания значения конца диапазона. Для установки или получения значения левого поля (начала диапазона) используется обычная команда RDS_FORMVAL_VALUE.

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

  int iCtrlId= … // Идентификатор поля ввода
  int iValue= …  // Значение
  rdsSetObjectInt(Win,iCtrlId,RDS_FORMVAL_RANGEMAX,iValue);

или

  int iCtrlId= …   // Идентификатор поля ввода
  double dValue= … // Значение
  rdsSetObjectDouble(Win,iCtrlId,RDS_FORMVAL_RANGEMAX,dValue);

или

  int iCtrlId= …     // Идентификатор поля ввода
  RDSCSTR sValue= …  // Значение в виде строки (UTF8)
  rdsSetObjectStrA(Win,iCtrlId,RDS_FORMVAL_RANGEMAX,sValue);

или

  int iCtrlId= …     // Идентификатор поля ввода
  RDSWCSTR sValue= … // Значение в виде строки (UTF16)
  rdsSetObjectStrW(Win,iCtrlId,RDS_FORMVAL_RANGEMAX,sValue);

или (через функцию-псевдоним)

  int iCtrlId= …     // Идентификатор поля ввода
  RDSXCSTR sValue= … // Значение в виде строки (кодировка по умолчанию)
  rdsSetObjectStr(Win,iCtrlId,RDS_FORMVAL_RANGEMAX,sValue);

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

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

или

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

или

  int iCtrlId= … // Идентификатор поля ввода
  RDSCSTR sValue=rdsGetObjectStrA(Win,iCtrlId,RDS_FORMVAL_RANGEMAX); // UTF8

или

  int iCtrlId= … // Идентификатор поля ввода
  RDSWCSTR sValue=rdsGetObjectStrW(Win,iCtrlId,RDS_FORMVAL_RANGEMAX); // UTF16

или (через функцию-псевдоним)

  int iCtrlId= … // Идентификатор поля ввода
  RDSXCSTR sValue=rdsGetObjectStr(Win,iCtrlId,RDS_FORMVAL_RANGEMAX); // Кодировка по умолчанию

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

Win (RDS_HOBJECT): Идентификатор вспомогательного объекта для работы с модальным окном, ранее созданного функцией rdsFORMCreate.
iCtrlId (int): Целый идентификатор поля ввода, присвоенный ему при вызове функции rdsFORMAddEdit.
iValue (int): Значение поля в виде целого числа.
dValue (double): Значение поля в виде вещественного числа.
sValue (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку, в которой записано значение поля. При получении значения функцией rdsGetObjectStr в данном случае возвращается указатель на строку во внутренней памяти объекта Win, этот указатель будет действителен до тех пор, пока значение поля не изменится.

Примечания

Эта команда служит для доступа к правому полю двойного поля ввода RDS_FORMCTRL_RANGEEDIT. Для передачи команды полю ввода можно использовать целые функции rdsSetObjectInt и rdsGetObjectInt, вещественные rdsSetObjectDouble и rdsGetObjectDouble, а также строковые rdsSetObjectStr и rdsGetObjectStr – тип используемых функций зависит только от того, в каком виде удобнее передавать значение полю или получать его из поля.

Пример

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

См. также

RDS_FORMCTRL_RANGEEDIT, rdsFORMCreate, rdsFORMAddEdit, rdsSetObjectInt, rdsGetObjectInt, rdsSetObjectDouble, rdsGetObjectDouble, rdsSetObjectStr, rdsGetObjectStr, RDS_FORMVAL_VALUE.