1С Предприятие 7.7. Документация
ОткрытьФорму
Выполняет открытие формы из'встроенного языка.
Синтаксис:
ОткрытьФорму (<Параметр1>, <КонтекстФормы>, < Параметр 3>...)
Англоязычный синоним:
OpenForm
Параметры:
| <Параметр1> | В зависимости от типа открываемой формы используется различные значения данного параметра.
Для журналов, отчетов, списков в конце строки описателя формы может быть указан символ "#" с некоторым идентификатором: "#LLLL". Это используется для того, чтобы данная форма открылась в новом окне, а не активизировала существующее окно этой формы, если оно открыто. Где, LLLL — идентификатор, который позволяет открыть новое окно или активизировать уже открытое с этим идентификатором. Если идентификатор не задан, то обязательно открывается новое окно. | ||
| <КонтекстФормы> | Необязательный параметр. Имя переменной, куда можно задать значение любого типа для передачи в открываемую форму. Данное значение будет доступно в открытой форме как атрибут Форма.Параметр.
После исполнения данного метода система вернет в данную переменную контекст открытой формы (см. Передача контекста в качестве параметра). С помощью значения этого контекста можно затем произвольно манипулировать открытой формой, пока она открыта. Пока форма открыта, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта — 0. | ||
| <Параметр3>... | В зависимости от типа открываемой формы используется различный состав и значения остальных параметров. |
Возвращаемое значение:
Число 1 — если действие выполнено;
Число 0 — если действие не выполнено.
Описание:
Функция ОткрытьФорму позволяет открыть форму документа, справочника, журнала документов, и других форм используемых в системе 1С:Предприятие.
Замечание. Для журналов, отчетов, списков в конце строки описателя формы может быть указан символ "#" с некоторым идентификатором: "#LLLL". Это используется для того, чтобы данная форма открылась в новом окне, а не активизировала существующее окно этой формы, если оно открыто. Где, LLLL — идентификатор, который позволяет открыть новое окно или активизировать уже открытое с этим идентификатором. Если идентификатор не задан, то обязательно открывается новое окно.
Замечание. Метод ОткрытьФорму нельзя вызывать в «теле» глобального модуля ( части глобального модуля, расположенной после последней процедуры). Для его вызова при старте программы следует размещать его в процедуре ПриНачалеРаботыСистемы.
Для открытия разных форм следует использовать разный синтаксис вызова данной функции:
Открытие формы существующего документа.
ОткрытьФорму(<Документ>, <КонтекстФормы>, <РежимПросмотра>)
|
<Документ> |
Значение типа «Документ». |
|
<РежимПросмотра> |
Необязательный параметр. Числовое выражение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотренный текущим значением параметра «Режим открытия объектов» установленного пользователем. По умолчанию — 0. |
