Текущий раздел:

Описания RDS

Приложения

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

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

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

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

# Приложения

## Приложение А. Функции, константы и структуры 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.