Описание встроенного языка системы 1С Предприятие

       

ОткрытьФорму


Выполняет открытие формы из'встроенного языка.

Синтаксис:

ОткрытьФорму (<Параметр1>, <КонтекстФормы>, < Параметр 3>...)

Англоязычный синоним:

OpenForm

Параметры:

<Параметр1>

В зависимости от типа открываемой формы используется различные значения данного параметра.

Для журналов, отчетов, списков в конце строки описателя формы может быть указан символ "#" с некоторым идентификатором: "#LLLL". Это используется для того, чтобы данная форма открылась в новом окне, а не активизировала существующее окно этой формы, если оно открыто. Где, LLLL — иден­тификатор, который позволяет открыть но­вое окно или активизировать уже открытое с этим идентификатором. Если идентификатор не задан, то обязательно открывается новое окно.



<КонтекстФормы>

Необязательный параметр. Имя переменной, куда можно задать значение любого типа для передачи в открываемую форму. Данное зна­чение будет доступно в открытой форме как атрибут Форма.Параметр.

После исполнения данного метода система вернет в данную переменную контекст от­крытой формы (см. Передача контекста в качестве параметра). С помощью значения этого контекста можно затем произвольно манипулировать открытой формой, пока она открыта. Пока форма открыта, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта — 0.

<Параметр3>...

В зависимости от типа открываемой формы используется различный состав и значения остальных параметров.

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

Число 1 — если действие выполнено;

Число 0 — если действие не выполнено.

Описание:

Функция ОткрытьФорму позволяет открыть форму документа, справочни­ка, журнала документов, и других форм используемых в системе 1С:Предприятие.

Замечание. Для журналов, отчетов, списков в конце строки описателя формы может быть указан символ "#" с некоторым идентификатором: "#LLLL". Это используется для того, чтобы данная форма открылась в новом окне, а не активизировала существующее окно этой формы, если оно открыто. Где, LLLL — идентификатор, который позволяет открыть новое окно или активизировать уже открытое с этим идентификатором. Если идентифи­катор не задан, то обязательно открывается новое окно.




Замечание. Метод ОткрытьФорму нельзя вызывать в «теле» глобального мо­дуля ( части глобального модуля, расположенной после последней проце­дуры). Для его вызова при старте программы следует размещать его в процедуре ПриНачалеРаботыСистемы.

Для открытия разных форм следует использовать разный синтаксис вызова данной функции:

Открытие формы существующего документа.

ОткрытьФорму(<Документ>, <КонтекстФормы>, <РежимПросмотра>)

<Документ>

Значение типа «Документ».

<РежимПросмотра>

Необязательный параметр. Числовое выра­жение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотрен­ный текущим значением параметра «Режим открытия объектов» установленного поль­зователем. По умолчанию — 0.


Содержание раздела