Приложения

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

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

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

А.5.28.21. Команда RDS_FORMVAL_PBBEVEL – установка рамки вокруг области рисования

Команда RDS_FORMVAL_PBBEVEL включает или выключает рамку вокруг области программного рисования RDS_FORMCTRL_PAINTBOX. По умолчанию рамка включена.

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

  int iCtrlId= … // Идентификатор поля ввода
  int iEnable= … // 1 – включить рамку, 0 - выключить
  rdsSetObjectInt(Win,iCtrlId,RDS_FORMVAL_PBBEVEL,iEnable);

или

  int iCtrlId= …      // Идентификатор поля ввода
  RDSCSTR sEnable= …  // "1" – включить рамку, "0" - выключить (UTF8)
  rdsSetObjectStrA(Win,iCtrlId,RDS_FORMVAL_PBBEVEL,sEnable);

или

  int iCtrlId= …      // Идентификатор поля ввода
  RDSWCSTR sEnable= … // "1" – включить рамку, "0" - выключить (UTF16)
  rdsSetObjectStrW(Win,iCtrlId,RDS_FORMVAL_PBBEVEL,sEnable);

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

  int iCtrlId= …      // Идентификатор поля ввода
  RDSXCSTR sEnable= … // "1" – включить рамку, "0" - выключить (кодировка по умолчанию)
  rdsSetObjectStr(Win,iCtrlId,RDS_FORMVAL_PBBEVEL,sEnable);

Параметры

Win (RDS_HOBJECT): Идентификатор вспомогательного объекта для работы с модальным окном, ранее созданного функцией rdsFORMCreate.
iCtrlId (int): Целый идентификатор поля ввода, присвоенный ему при вызове функции rdsFORMAddEdit.
iEnable (int): Целое число, указывающее на разрешение (отличное от нуля значение) или запрещение (нулевое значение) отображения рамки.
sEnable (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку, в которой записано целое число, указывающее на разрешение (отличное от нуля значение) или запрещение (нулевое значение) отображения рамки. Пустая строка запрещает отображение рамки.

Примечания

Признак наличия рамки имеет смысл передавать полю ввода только до открытия окна, поскольку в момент открытия окна общий вид всех объектов, включая наличие рамок, в нем фиксируются до тех пор, пока окно не будет закрыто.

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

См. также

RDS_FORMCTRL_PAINTBOX, rdsFORMCreate, rdsFORMAddEdit, rdsSetObjectInt, rdsSetObjectStr.