Приложения

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

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

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

А.5.28.24. Команда RDS_FORMVAL_UPDOWNINC – шаг изменения поля ввода со стрелками

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

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

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

или

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

или

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

или

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

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

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

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

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

или

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

или

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

или

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

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

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

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

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_UPDOWNINC приведен в §2.10.1 руководства программиста.

См. также

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