Приложения

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

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

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

А.5.28.19. Команда RDS_FORMVAL_MLHEIGHT – высота многострочного поля ввода

Команда RDS_FORMVAL_MLHEIGHT устанавливает высоту в точках экрана для поля ввода нескольких строк типа RDS_FORMCTRL_MULTILINE.

Вызов команды

  int iCtrlId= … // Идентификатор поля ввода
  int iHeight= … // Высота поля
  rdsSetObjectInt(Win,iCtrlId,RDS_FORMVAL_MLHEIGHT,iHeight);

или

  int iCtrlId= …    // Идентификатор поля ввода
  double dHeight= … // Высота поля
  rdsSetObjectDouble(Win,iCtrlId,RDS_FORMVAL_MLHEIGHT,dHeight);

или

  int iCtrlId= …      // Идентификатор поля ввода
  RDSCSTR sHeight= …  // Высота поля в виде строки (UTF8)
  rdsSetObjectStrA(Win,iCtrlId,RDS_FORMVAL_MLHEIGHT,sHeight);

или

  int iCtrlId= …      // Идентификатор поля ввода
  RDSWCSTR sHeight= … // Высота поля в виде строки (UTF16)
  rdsSetObjectStrW(Win,iCtrlId,RDS_FORMVAL_MLHEIGHT,sHeight);

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

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

Параметры

Win (RDS_HOBJECT): Идентификатор вспомогательного объекта для работы с модальным окном, ранее созданного функцией rdsFORMCreate.
iCtrlId (int): Целый идентификатор поля ввода, присвоенный ему при вызове функции rdsFORMAddEdit.
iHeight (int): Высота поля в точках экрана или −1, если нужно, чтобы поле заняло по высоте всю оставшуюся часть окна.
dHeight (double): Высота поля в точках экрана в виде вещественного числа или −1.0, если нужно, чтобы поле заняло по высоте всю оставшуюся часть окна.
sHeight (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку, в которой записана высота поля в точках экрана. Строка «−1» указывает на то, что поле должно занять по высоте всю оставшуюся часть окна.

Примечания

Эта команда задает высоту поля ввода типа RDS_FORMCTRL_MULTILINE. Высоту имеет смысл передавать полю ввода только до открытия окна, поскольку в момент его открытия размеры всех объектов в нем фиксируются до тех пор, пока окно не будет закрыто.

Для передачи команды полю ввода можно использовать любую из функций rdsSetObjectInt, rdsSetObjectDouble и rdsSetObjectStr. Чаще всего используется целая функция rdsSetObjectInt, поскольку высота поля – целое число. При использовании rdsSetObjectStr переданная строка будет преобразована в целое число по правилам функции rdsAtoI.

Пример

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

См. также

RDS_FORMCTRL_MULTILINE, rdsFORMCreate, rdsFORMAddEdit, rdsSetObjectInt, rdsSetObjectDouble, rdsSetObjectStr.