0

Функция ПолучитьФорму()

Возвращает форму по имени

Синтаксис

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

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

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

Form GetForm(Name, [Params], [Owner], [Unique], [Window], [NavLink])

Параметры

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

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

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

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

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

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

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

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

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

Описание

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

Если в параметре Уникальность передано значение Истина, то поиск уже открытых форм не осуществляется.

Доступность

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

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

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

Форма = ПолучитьФорму("Справочник.Сотрудники.Форма.ФормаОбъекта");

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

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

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

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