Приложения

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

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

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

Описываются функции и команды вспомогательного объекта RDS, предназначенного для открытия модальных окон с различными полями ввода.

А.5.28.1. rdsFORMCreate – создать объект для работы с окном

Функция rdsFORMCreate создает вспомогательный объект RDS, позволяющий открыть модальное окно с различными полями для ввода параметров.

  RDS_HOBJECT RDSCALL rdsFORMCreateA(
    BOOL Tabbed,     // У окна есть вкладки
    int Width,       // Ширина окна или -1
    int Height,      // Высота окна или -1
    RDSCSTR Caption  // Заголовок окна (UTF8)
  );
  RDS_HOBJECT RDSCALL rdsFORMCreateW(
    BOOL Tabbed,     // У окна есть вкладки
    int Width,       // Ширина окна или -1
    int Height,      // Высота окна или -1
    RDSWCSTR Caption // Заголовок окна (UTF16)
  );
  // Функция-псевдоним
  RDS_HOBJECT RDSCALL rdsFORMCreate(
    BOOL Tabbed,     // У окна есть вкладки
    int Width,       // Ширина окна или -1
    int Height,      // Высота окна или -1
    RDSXCSTR Caption // Заголовок окна (кодировка по умолчанию)
  );

Тип указателя на эту функцию

RDS_HoBIIS (для UTF8) или RDS_HoBIIWs (для UTF16)

Параметры

Tabbed (BOOL): TRUE – внутри окна будет несколько вкладок, каждая со своими полями ввода. FALSE – окно не будет иметь вкладок.
Width (int): Ширина окна в точках экрана, или −1, если ширину нужно автоматически подобрать так, чтобы все поля ввода уместились в окно.
Height (int): Высота окна в точках экрана, или −1, если высоту нужно автоматически подобрать так, чтобы все поля ввода уместились в окно.
Caption (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку с заголовком окна.

Возвращаемое значение

Уникальный идентификатор созданного объекта (RDS_HOBJECT).

Примечания

Эта функция создает вспомогательный объект, с помощью которого можно открывать модальные окна для редактирования различных параметров. Поля ввода различных типов добавляются в объект функцией rdsFORMAddEdit. Для открытия окна используется команда RDS_FORM_SHOWMODAL или сервисные функции rdsFORMShowModalEx и rdsFORMShowModalServ.

Созданный вспомогательный объект будет существовать до тех пор, пока схема не будет выгружена из памяти, или пока он не будет удален вызовом функции rdsDeleteObject.

Обычно работа с модальным окном при помощи данного вспомогательного объекта строится по следующему сценарию:

объект создается вызовом rdsFORMCreate;
вызовами rdsFORMAddEdit в объект добавляются поля ввода;
различными командами – RDS_FORMVAL_VALUE и другими – в поля ввода записываются значения;
окно объекта открывается командой RDS_FORM_SHOWMODAL, вызовом rdsFORMShowModalEx или rdsFORMShowModalServ;
если пользователь закрыл окно кнопкой «OK», измененные значения считываются из полей ввода;
объект удаляется вызовом rdsDeleteObject.

Пример

Примеры использования функции rdsFORMCreate приведены в руководстве программиста: §2.7.2, §2.10.1 и др.

См. также

Вспомогательные объекты, rdsDeleteObject, rdsFORMAddEdit, rdsFORMShowModalEx, rdsFORMShowModalServ, RDS_FORM_SHOWMODAL.