Оглавление | Родительский раздел

СправочникМенеджер.<Имя справочника>.ПолучитьФорму (CatalogManager.<Имя справочника>.GetForm)

СправочникМенеджер.<Имя справочника> (CatalogManager.<Имя справочника>)
ПолучитьФорму (GetForm)

Синтаксис:

ПолучитьФорму(<Форма>, <Владелец>, <КлючУникальности>)

Параметры:

<Форма> (обязательный)

Тип: Строка; ОбъектМетаданных: Форма .
Имя формы, как оно задано в конфигураторе, или объект описания метаданного требуемой формы.

<Владелец> (необязательный)

Тип: Форма; Элемент управления.
Объект, который будет являться владельцем открываемой формы.

<КлючУникальности> (необязательный)

Тип: Произвольный.
В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм.
При поиске учитываются значения свойств открытых форм соответствующим значениям параметров метода. Если найдена открытая форма (по совпадению всех параметров), то она будет возвращена вместо новой формы.
Если из некой формы (один и тот же владелец) требуется открывать новые экземпляры другой формы, то при каждом вызове метода значение данного параметра должно быть уникально (в рамках соответствующих значений свойств открытых форм).
Значение параметра присваивается свойству открываемой формы КлючУникальности.
Следует учитывать, что при получении формы из "объекта" система получает форму для конкретного экземпляра объекта с учетом совокупности переданных параметров, в то время как для "ссылки" всегда существует только один объект в базе данных и форма получается одна (для одинаковой совокупности параметров).

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

Тип: Форма; Неопределено.
Неопределено - если в обработчике ПриСозданииНаСервере установлен признак отказа от создания формы.

Описание:

Получает форму справочника. Если получаемая форма - форма для редактирования элемента или группы справочника, то будет получена форма нового элемента или группы.

Доступность:

Толстый клиент.

Примечание:

Перед выполнением метода производиться анализ параметров вызова и, при необходимости, происходит переадресация вызова глобальному контексту.

Пример:

Товары = Справочники.Номенклатура;
ФормаСписка= Товары.ПолучитьФорму("ФормаСписка");
Если Не ФормаСписка.Открыта() Тогда
    ФормаСписка.Открыть();
КонецЕсли;
Оглавление | Родительский раздел Платформа 8.3.13.1809