АктивизироватьОбъект

Установить курсор в списке на выбранном объекте.

Синтаксис:

АктивизироватьОбъект(<Объект>)

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

ActivateObj

Параметры:

<Объект>

Выражение, которое может содержать значение элемента справочника или документ или запись журнала расчетов (в зависимости от типа модуля формы, в котором должен быть активизирован эле­мент диалога).

Описание:

Метод АктивизироватьОбъект, который доступен только в контексте Модуля формы, устанавливает курсор на нужной строке списка диалога, на­пример документ в форме журнала или элемент в форме списка справочника, или запись расчета в форме журнала расчетов.

Пример:

АктивизироватьОбъект(ВыбДокумент);

Предопределенные процедуры Модуля формы

Описанные в данном разделе системные предопределенные процедуры должны располагаться только в Модулях форм (см. «Виды программных моду­лей»). К Модулям форм относятся практически все программные модули (ис­ключение составляют Глобальный модуль, Модуль документа, Модуль вида расчета).

В основном данные процедуры предназначены для расширения возможно­сти программного управления правами доступа к системе.

Предопределенные процедуры не является встроенными процедурами язы­ка. Для них зарезервированы только название и синтаксис. Тело процедур должно быть написано самим разработчиком в соответствующих программных модулях. Вызов предопределенных процедур на исполнение производится в системе 1С:Предприятие неявно при возникновении соответствующего собы­тия. Описание предопределенных процедур также см. гл. «Системные предо­пределенные процедуры».

ПриОткрытии

Предопределенная процедура при открытии формы.

Синтаксис:

ПриОткрытии()

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

OnOpen

Описание:

Вызов предопределенной процедуры ПриОткрытии производится самой системой 1С:Предприятие неявно при интерактивном открытии формы. Если в данной предопределенной процедуре установить статус возврата — 0 (напри­мер, если данному пользователю зыпрещено просматривать форму объекта), открытие формы не будет выполнено.

Данная предопределенная процедура может располагаться только в про­граммном модуле формы.

Пример:

Процедура ПриОткрытии()

ПриЗаписиПерепроводить(1);

КонецПроцедуры

См. также: СтатусВозврата

ПриПовторномОткрытии

Предопределенная процедура при повторном открытии формы.

Синтаксис:

ПриПовторномОткрытии()

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

OnReopen

Описание:

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

Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю запрещено просматривать форму объ­екта), открытие формы не будет выполнено.

Данная предопределенная процедура может располагаться только в про­граммном модуле формы.

Пример:

Процедура ПриПовторномОткрытии()

ПриЗаписиПерепроводить(1);

КонецПроцедуры

См. также: СтатусВозврата

ПриЗакрытии

Предопределенная процедура при закрытии формы.

Синтаксис:

ПриЗакрытии()

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

OnClose

Описание:

Вызов предопределенной процедуры ПриЗакрытии производится самой системой 1С:Предприятие неявно при интерактивном закрытии формы. Если в данной предопределенной процедуре установить статус возврата — 0 (напри­мер, если неверно или не полностью заполнены реквизиты объекта), закрытие формы не будет выполнено.

Данная предопределенная процедура может располагаться только в про­граммном модуле формы.

Пример:

Процедура ПриЗакрытии()

Если ПоСчетуФактуре.Выбран() = 0 Тогда

Предупреждение("Укажите Счет-Фактуру", 4);

СтатусВозврата(0);

КонецЕсли;

КонецПроцедуры

См. также: СтатусВозврата