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