0

Функция ОткрытьФорму()

Открывает произвольную форму

Функция ОткрытьФорму() имеет несколько вариантов синтаксиса:

Вариант синтаксиса 1: По имени

Функция ОткрытьФорму() имеет следующий синтаксис:

Форма ОткрытьФорму(ИмяФормы, [Параметры], [Владелец], [Уникальность], [Окно], [НавигационнаяСсылка], [ОповещениеОЗакрытии], [РежимОткрытияОкна])

А также альтернативный англоязычный синтаксис:

Form OpenForm(Name, [Params], [Owner], [Unique], [Window], [NavLink], [ClosingNotification], [OpeningMode])

Параметры

Описание параметров процедуры ОткрытьФорму():

Имя параметра Тип Описание
ИмяФормы Строка Имя формы, образованное как полный путь к объекту Форма в дереве метаданных (например, «Справочник.Номенклатура.Форма.ФормаОбъекта», «ОбщаяФорма.ФормаПредупреждения») или как полный путь к прикладному объекту, дополненный именем формы по умолчанию (например, «Справочник.Номенклатура.ФормаОбъекта»). Поддерживаются следующие формы по умолчанию:

  • ФормаОбъекта (ObjectForm) — форма объекта по умолчанию;
  • ФормаГруппы (FolderForm) — форма группы по умолчанию;
  • ФормаЗаписи (RecordForm) — форма записи регистра по умолчанию;
  • ФормаСписка (ListForm) — форма списка по умолчанию;
  • ФормаВыбора (ChoiceForm) — форма выбора по умолчанию;
  • ФормаВыбораГруппы (FolderChoiceForm) — форма выбора группы по умолчанию;
  • ФормаКонстант (ConstantsForm) — форма констант по умолчанию;
  • Форма (Form) — форма отчета и обработки по умолчанию;
  • ФормаНастроек (SettingsForm) — форма настроек отчета по умолчанию;
  • ФормаЗагрузки (LoadForm) — форма загрузки настроек;
  • ФормаСохранения (SaveForm) — форма сохранения настроек;
Параметры (необязательный) Структура Параметры формы. Ключ структуры — имя параметра, а значение — значение параметра формы
Владелец (необязательный) ВладелецФормы Форма или элемент управления формы.
Уникальность (необязательный) Произвольный Ключ уникальности формы. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована найденная форма
Окно (необязательный) ОкноКлиентского-Приложения Окно приложения, в котором будет открыта форма. Окном может быть только основное окно приложения или вспомогательное окно формы.

Применимо только для управляемой формы.

НавигационнаяСсылка (необязательный) Строка;
Неопределено
Если содержит значение, отличное от Неопределено, то это значение присваивается свойству НавигационнаяСсылка формы, полученной в результате вызова данного метода, и свойство АвтоНавигационнаяСсылка этой формы устанавливается в Ложь. Значение по умолчанию: Неопределено.

Применимо только для управляемой формы.

ОповещениеОЗакрытии (необязательный) ОписаниеОповещения Содержит описание процедуры, расположенной в текущем или в общем модуле, которая будет вызвана при закрытии открываемой формы
РежимОткрытияОкна (необязательный) РежимОткрытия-ОкнаФормы Указывает режим открытия окна управляемой формы. Используется только в управляемом приложении. Варианты значений:

  • БлокироватьВеcьИнтерфейс — Блокировать весь интерфейс. При этом блокируется работа всех остальных открытых окон приложения, включая главное окно
  • БлокироватьОкноВладельца — Блокировать только форму-владельца, переданного в параметре ВладелецФормы. Новое окно открывается поверх окна-владельца
  • Независимый — Независимое окно (обычный режим открытия формы). В интерфейсе «В отдельных окнах» открывается отдельное окно, а в интерфейсах «В закладках» или «Такси» форма открывается в рабочей области основного окна
Жирным шрифтом выделены обязательные параметры

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

Форма; УправляемаяФорма

Описание варианта 1

Функция ОткрытьФорму() открывает форму по имени. Перед открытием осуществляется поиск ранее открытой формы того же типа и совпадающими параметрами: значениям ключевых параметров формы, владельца формы, пользовательского ключа уникальности. Для форм ФормаОбъекта, ФормаЗаписи, ФормаНабораЗаписей, ФормаКонстант при поиске ранее открытых форм, владелец не учитывается.

Вариант синтаксиса 2: По форме

Функция ОткрытьФорму() имеет следующий синтаксис:

Форма ОткрытьФорму(Форма, [Окно])

А также альтернативный англоязычный синтаксис:

Form OpenForm(Form, [Window])

Параметры

Описание параметров процедуры ОткрытьФорму():

Имя параметра Тип Описание
Форма Форма; УправляемаяФорма Форма или управляемая форма. В режиме тонкого и веб-клиентов только управляемая форма.
Окно (необязательный) ОкноКлиентскогоПриложения Окно приложения, в котором будет открыта форма. Окном может быть только основное окно приложения или вспомогательное окно формы.

Применимо только для управляемой формы.

Жирным шрифтом выделены обязательные параметры

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

Форма; УправляемаяФорма

Описание варианта 2

Функция ОткрытьФорму() открывает форму, полученную ранее функциями ОткрытьФорму() или ПолучитьФорму()

Доступность

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение(клиент).

Пример использования

Пример кода с использованием процедуры ОткрытьФорму():

ОткрытьФорму("Справочник.ФизическиеЛица.Форма.ФормаПродавца");

Читайте также:

Работа с формами: программное открытие формы

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *