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