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