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

Описания RDS

Приложения

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

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

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

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

# Приложения

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