Получает форму списка для выбора документов.
Синтаксис
ПолучитьФормуВыбора(<Форма>, <Владелец>, <КлючУникальности>)Полное описание, параметры и ограничения
ДокументМенеджер.<Имя документа>.ПолучитьФормуВыбора (DocumentManager.<Document name>.GetChoiceForm)
ДокументМенеджер.<Имя документа> (DocumentManager.<Document name>)
ПолучитьФормуВыбора (GetChoiceForm)
Доступен, начиная с версии 8.0.
Синтаксис:
ПолучитьФормуВыбора(<Форма>, <Владелец>, <КлючУникальности>)
Параметры:
<Форма> (необязательный)
Тип: Строка, ОбъектМетаданных: Форма.
Имя формы, как оно задано в конфигураторе, или объект описания метаданного требуемой формы. Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> (необязательный)
Тип: Форма; Элемент управления.
Объект, который будет являться владельцем открываемой формы.
<КлючУникальности> (необязательный)
Тип: Произвольный.
В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм.
При поиске учитываются значения свойств открытых форм соответствующим значениям параметров метода. Если найдена открытая форма (по совпадению всех параметров), то она будет возвращена вместо новой формы.
Если из некой формы (один и тот же владелец) требуется открывать новые экземпляры другой формы, то при каждом вызове метода значение данного параметра должно быть уникально (в рамках соответствующих значений свойств открытых форм).
Значение параметра присваивается свойству открываемой формы КлючУникальности.
Следует учитывать, что при получении формы из "объекта" система получает форму для конкретного экземпляра объекта с учетом совокупности переданных параметров, в то время как для "ссылки" всегда существует только один объект в базе данных и форма получается одна (для одинаковой совокупности параметров).
Возвращаемое значение:
Тип: Форма, Неопределено.
Неопределено - если в обработчике ПриСозданииНаСервере установлен признак отказа от создания формы.
Описание:
Получает форму списка для выбора документов.
Доступность:
Толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Получить три обычные формы собственного документа
Это старые методы толстого клиента. Формы готовит менеджер метаданных; отказ создания может вернуть Неопределено.
Где и как запускать
Толстый клиент, модуль обычной формы.
Подготовка
Только собственная учебная конфигурация. Все указанные имена сначала создайте в Конфигураторе; объекты рабочей базы не заменяйте. Здесь код не запускается.
Толстый клиент в обычном приложении. У своего документа УчебнаяОперация создайте обычную ФормаДокумента и основную форму выбора. Вставьте блок в обычную форму учебной обработки. Открываемые новые документы не записывайте.
Процедура ОткрытьУчебныеФормыДокумента()
ФормаПоИмени = Документы.УчебнаяОперация.ПолучитьФорму("ФормаДокумента");
Если ФормаПоИмени <> Неопределено Тогда
ФормаПоИмени.Открыть();
КонецЕсли;
ФормаВыбора = Документы.УчебнаяОперация.ПолучитьФормуВыбора();
Если ФормаВыбора <> Неопределено Тогда
ФормаВыбора.Открыть();
КонецЕсли;
ФормаНового = Документы.УчебнаяОперация.ПолучитьФормуНовогоДокумента();
Если ФормаНового <> Неопределено Тогда
ФормаНового.Открыть();
КонецЕсли;
КонецПроцедурыРазбор по шагам
Получите именованную форму.
Получите основную форму выбора.
Получите форму нового документа и откройте только непустые результаты.
Как проверить результат
Первый обязательный аргумент ПолучитьФорму задан.
Отказ создания не превращается в вызов Открыть у Неопределено.
Ожидаемый результат
Показаны три разных пути получения реальных обычных форм собственного документа.
На что обратить внимание
ПолучитьФорму на менеджере может создавать новый документ, не открывать существующий. Для управляемых форм используйте их соответствующий интерфейс.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.