Приложения

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

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

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

А.5.28.26. Команда RDS_FORMVAL_UPDOWNMIN – минимальное значение поля ввода со стрелками

Команда RDS_FORMVAL_UPDOWNMIN устанавливает или возвращает минимальное значение поля ввода типа RDS_FORMCTRL_UPDOWN. Нажатием кнопок со стрелками нельзя будет установить в поле значение, меньшее переданного этой командой.

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

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

или

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

или

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

или

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

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

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

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

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

или

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

или

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

или

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

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

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

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

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

Примечания

Эта команда устанавливает или получает минимально допустимое значение поля RDS_FORMCTRL_UPDOWN, до которого его можно уменьшить кнопками-стрелками (вручную пользователь может ввести в это поле любое значение, в том числе и меньшее заданного минимального). Для передачи команды полю ввода можно использовать целые функции rdsSetObjectInt и rdsGetObjectInt, вещественные rdsSetObjectDouble и rdsGetObjectDouble, а также строковые rdsSetObjectStr и rdsGetObjectStr. Хотя минимальное значение может устанавливаться и строковой функцией rdsSetObjectStr, само поле может работать только с целыми или вещественными значениями, поэтому в передаваемой строке должно быть записано какое-либо число.

По умолчанию проверка минимального значений поля отключена, передача в поле любого числового значения командой RDS_FORMVAL_UPDOWNMIN включает ее. Для того, чтобы снова отключить проверку, следует передать в качестве нового минимального значения либо пустую строку при помощи функции rdsSetObjectStr, либо специальное значение-индикатор математической ошибки (возвращаемое функцией rdsGetHugeDouble) при помощи функции rdsSetObjectDouble.

Пример

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

См. также

RDS_FORMCTRL_UPDOWN, rdsFORMCreate, rdsFORMAddEdit, rdsSetObjectInt, rdsGetObjectInt, rdsSetObjectDouble, rdsGetObjectDouble, rdsSetObjectStr, rdsGetObjectStr.