Открывает произвольную форму
Функция ОткрытьФорму() имеет несколько вариантов синтаксиса:
Вариант синтаксиса 1: По имени
Функция ОткрытьФорму() имеет следующий синтаксис:
Форма ОткрытьФорму(ИмяФормы, [Параметры], [Владелец], [Уникальность], [Окно], [НавигационнаяСсылка], [ОповещениеОЗакрытии], [РежимОткрытияОкна])
А также альтернативный англоязычный синтаксис:
Form OpenForm(Name, [Params], [Owner], [Unique], [Window], [NavLink], [ClosingNotification], [OpeningMode])
Параметры
Описание параметров процедуры ОткрытьФорму():
| Имя параметра* | Тип | Описание |
|---|---|---|
| ИмяФормы | Строка | Имя формы, образованное как полный путь к объекту Форма в дереве метаданных (например, «Справочник.Номенклатура.Форма.ФормаОбъекта», «ОбщаяФорма.ФормаПредупреждения») или как полный путь к прикладному объекту, дополненный именем формы по умолчанию (например, «Справочник.Номенклатура.ФормаОбъекта»). Поддерживаются следующие формы по умолчанию:
|
| Параметры | Структура | Параметры формы. Ключ структуры — имя параметра, а значение — значение параметра формы |
| Владелец | ВладелецФормы | Форма или элемент управления формы. |
| Уникальность | Произвольный | Ключ уникальности формы. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована найденная форма |
| Окно | ОкноКлиентскогоПриложения | Окно приложения, в котором будет открыта форма. Окном может быть только основное окно приложения или вспомогательное окно формы.
Применимо только для управляемой формы. |
| НавигационнаяСсылка | Строка; Неопределено | Если содержит значение, отличное от Неопределено, то это значение присваивается свойству НавигационнаяСсылка формы, полученной в результате вызова данного метода, и свойство АвтоНавигационнаяСсылка этой формы устанавливается в Ложь. Значение по умолчанию: Неопределено.
Применимо только для управляемой формы. |
| ОповещениеОЗакрытии | ОписаниеОповещения | Содержит описание процедуры, расположенной в текущем или в общем модуле, которая будет вызвана при закрытии открываемой формы |
| РежимОткрытияОкна | РежимОткрытияОкнаФормы | Указывает режим открытия окна управляемой формы. Используется только в управляемом приложении. Варианты значений:
|
| *Жирным шрифтом выделены обязательные параметры | ||
Возвращаемое значение
Форма; УправляемаяФорма
Описание варианта 1
Функция ОткрытьФорму() открывает форму по имени. Перед открытием осуществляется поиск ранее открытой формы того же типа и совпадающими параметрами: значениям ключевых параметров формы, владельца формы, пользовательского ключа уникальности. Для форм ФормаОбъекта, ФормаЗаписи, ФормаНабораЗаписей, ФормаКонстант при поиске ранее открытых форм, владелец не учитывается.
Вариант синтаксиса 2: По форме
Функция ОткрытьФорму() имеет следующий синтаксис:
Форма ОткрытьФорму(Форма, [Окно])
А также альтернативный англоязычный синтаксис:
Form OpenForm(Form, [Window])
Параметры
Описание параметров процедуры ОткрытьФорму():
| Имя параметра* | Тип | Описание |
|---|---|---|
| Форма | Форма; УправляемаяФорма | Форма или управляемая форма (d режиме тонкого и веб-клиентов только управляемая форма) |
| Окно | ОкноКлиентскогоПриложения | Окно приложения, в котором будет открыта форма. Окном может быть только основное окно приложения или вспомогательное окно формы.
Применимо только для управляемой формы. |
| *Жирным шрифтом выделены обязательные параметры | ||
Возвращаемое значение
Форма; УправляемаяФорма
Описание варианта 2
Функция ОткрытьФорму() открывает форму, полученную ранее функциями ОткрытьФорму() или ПолучитьФорму()
Доступность
| Версия | Поддержка |
|---|---|
| 8.1 | не поддерживается! |
| 8.2 | Толстый клиент, Тонкий клиент, Веб-клиент |
| 8.3 | Толстый клиент, Тонкий клиент, Веб-клиент, Мобильный клиент, Мобильное приложение |
Пример использования
Пример кода с использованием процедуры ОткрытьФорму():
ОткрытьФорму("Справочник.ФизическиеЛица.Форма.ФормаПродавца");
Читайте также:
Работа с формами: программное открытие формы
Поделиться страницей в соц.сетях