0

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

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

Синтаксис

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

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

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

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

Параметры

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

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

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

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

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

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

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

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

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

Описание

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

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

Доступность

Версия Поддержка
8.1 не поддерживается!
8.2 Толстый клиент, Тонкий клиент, Веб-клиент
8.3 Толстый клиент, Тонкий клиент, Веб-клиент, Мобильный клиент, Мобильное приложение
Внимание! В тонком и веб-клиенте получает только форму клиентского приложения.
Внимание!! Обычные формы внешних обработок не поддерживаются

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

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

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

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

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

Поделиться страницей в соц.сетях

Метки: Метки

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

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