Приложения

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

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

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

А.5.28.22. Команда RDS_FORMVAL_PBHEIGHT – высота области программного рисования

Команда RDS_FORMVAL_PBHEIGHT устанавливает высоту в точках экрана для области программного рисования типа RDS_FORMCTRL_PAINTBOX.

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

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

или

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

или

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

или

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

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

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

Параметры

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

Примечания

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

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

Пример

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

См. также

RDS_FORMCTRL_PAINTBOX, rdsFORMCreate, rdsFORMAddEdit, rdsSetObjectInt, rdsSetObjectDouble, rdsSetObjectStr.