IForm.CreateFormControl

Синтаксис

CreateFormControl(pParent: Object): Object;

Параметры

pParent. Форма, которая будет являться владельцем создаваемой формы.

В качестве значения параметра должен передаваться объект, реализуемый интерфейсом IWin32Window. Если в качестве значения передается Null, то создаваемая форма будет равноправна той, в которой её создали.

Описание

Метод CreateFormControl осуществляет создание новой формы и возвращает контекст для управления данной формой.

Комментарии

Для доступа к параметрам созданной формы необходимо результат работы метода привести к типу IFormControl.

Для открытия созданной формы установите свойству Visible значение True. Если указан параметр pParent, то созданная форма всегда будет отображаться поверх указанного родительского окна. Параметры родительского окна также будут доступны в свойстве ParentWindow.

Также для открытия формы можно использовать метод ShowModal. При этом форма будет открыта модально относительно указанного родительского окна.

Примечание. Если при создании формы в качестве значения параметра pParent передается Null и для отображения формы используется метод ShowModal, то форма открывается модально относительно навигатора объектов.

Пример

Для выполнения примера предполагается наличие формы и расположенной на ней кнопки с наименованием "Button1". В репозитории также имеется форма с идентификатором "TestForm".

Sub Button1OnClick(Sender: Object; Args: IMouseEventArgs);

Var

MB: IMetabase;

f: IFormControl;

Begin

MB := MetabaseClass.Active;

f := (MB.ItemById("TestForm").Bind As IForm).CreateFormControl(Self) As IFormControl;

f.ShowModal;

End Sub Button1OnClick;

После выполнения примера будет создана и выведена на экран форма "TestForm". Данная форма будет открыта модально относительно формы, при выполнении которой она была создана.

См. также:

IForm