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