Глава 30
Атрибуты и методы контекста Модуля формы

• Атрибуты контекста Модуля формы
  • СтрокаДействийФормы
  • Форма
• Атрибуты объекта Форма
  • Закладки
  • <ЭлементДиалога>
  • Параметр
• Методы объекта Форма
  • ТолькоПросмотр
  • Обновить
  • ИспользоватьЗакладки
  • ИспользоватьСлой
  • Заголовок
  • ПанельИнструментов
  • КнопкаПоУмолчанию
  • ОбработкаВыбораСтроки
  • ВыполнитьВыбор
  • РежимВыбора
  • МодальныйРежим
  • ПолучитьАтрибут
  • АктивныйЭлемент
  • ТекущаяКолонка
  • Закрыть
• Методы элементов диалога
  • Видимость
  • Доступность
  • Редактирование
  • Цвет
  • Маска
  • ВыборГруппы
  • ВыполнятьФормулуТолькоПриИзменении
  • Заголовок
  • УстановитьТип
  • НазначитьТип
  • НеИзменятьВид
• Методы контекста Модуля формы
  • ОткрытьПодбор
  • УстановитьЗначениеВПодборе
  • ПолучитьЗначениеИзПодбора
  • Активизировать
  • АктивизироватьОбъект
• Предопределенные процедуры Модуля формы
  • ПриОткрытии
  • ПриПовторномОткрытии
  • ПриЗакрытии
  • ПриВыбореЗакладки
  • ПриНачалеВыбораЗначения
  • ОбработкаПодбора
  • ОбработкаВыбораЗначения
  • ПриВыбореСтроки
• Атрибуты и методы контекста Модуля формы отчета (обработки)
  • Таблица
  • <ИмяОбласти>
  • РасположениеФайла
• Предопределенные процедуры модуля формы отчета (обработки)
  • ВводНового
  • ПриОткрытии

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

Атрибуты контекста Модуля формы

СтрокаДействийФормы

Содержит командную строку системных действий в кнопке формы.

Синтаксис:

СтрокаДействийФормы

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

StringFormActions

Описание:

Атрибут СтрокаДействийФормы предоставляет доступ к значению командной строки кнопки формы (строка системных команд в свойствах кнопки после символа #). Данный атрибут доступен в процедуре, вызываемой перед знаком # из строки формулы кнопки (кнопка — «Свойства» — «Дополнительные» — «Формула»).

Доступ к данному атрибуту возможен только в контексте Модуля формы.

Пример:

* Допустим, что в некоторой форме в свойствах какой-либо кнопки записана следующая формула:

УстКоманд() # Записать? Провести? Закрыть?

В программном модуле можно записать процедуру, которая будет устанавливать значение командной строки действий:

Процедура УстКоманд()

   Если НазваниеНабораПрав() = "Продавец" Тогда

      СтрокаДействийФормы = "Записать? Закрыть?";

   ИначеЕсли НазваниеНабораПрав() = "Менеджер" Тогда

      СтрокаДействийФормы = "Записать? Провести? Закрыть?";

   Иначе

      СтрокаДействийФормы = "Закрыть?";

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

Форма

Объект агрегатного типа «Форма».

Синтаксис:

Форма

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

Form

Описание:

Атрибут Форма представляет собой ссылку на объект типа «Форма». Атрибуты и методы объекта «Форма» позволяют в программном модуле изменять свойства визуального отображения диалога в целом (такие как Заголовок, Закладки и т. п.), а также свойства визуального отображения отдельных элементов диалога.

В тексте программного модуля через точку после имени атрибута «Форма» можно записывать идентификаторы элементов диалога, а далее через точку можно вызывать методы управления свойствами этих элементов.

Доступ к данному атрибуту возможен только в контексте Модуля формы.

Пример:

Форма.ТолькоПросмотр(0);

Форма.Prompt.Видимость(0);

Атрибуты объекта Форма

Закладки

Объект типа «СписокЗначений», содержащий описания закладок текущей формы.

Синтаксис:

Закладки

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

TabCtrl

Описание:

Атрибут объекта «Форма» Закладки представляет собой объект типа «СписокЗначений», содержащий описания закладок текущей формы. Данный атрибут предоставляет возможность программно манипулировать порядком и названиями закладок формы. В тексте программного модуля через точку после имени объекта «Форма» можно вызвать атрибут «Закладки», а далее через точку можно вызывать методы управления закладками как объектом типа «СписокЗначений».

Доступ к данному атрибуту возможен только в контексте Модуля формы после применения метода ИспользоватьЗакладки.

Пример:

Процедура ОбработкаКлиектов()

   Если ФлагФранчайзи = 1 Тогда

      Если Форма.Закладки.НайтиЗначение(2) = 0 Тогда

         Форма.Закладки.ДобавитьЗначение(2, "Поставщики");

      КонецЕсли;

   Иначе

      Позиция = Форма.Закладки.НайтиЗначение(2);

      Если Позиция > 0 Тогда

         Форма.Закладки.УдалитьЗначение(Позиция);

      КонецЕсли;

   КонецЕсли;

   форма.Закладки.Сортировать();

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

См. также: ИспользоватьЗакладки, ПриВыбореЗакладки, «Работа со СпискомЗначений»

<ЭлементДиалога>

Объект агрегатного типа «элемент диалога».

Синтаксис:

<ЭлементДиалога>

Описание:

Значение атрибута объекта «Форма» <ЭлементДиалога> представляет собой ссылку на элемент диалога. Элементы диалога — это объекты специального агрегатного типа. Методы элементов диалога позволяют в программном модуле изменять их свойства, такие как Цвет, Видимость, Доступность.

В тексте программного модуля через точку после имени объекта «Форма» можно вызвать атрибут <ЭлементДиалога>, а далее через точку можно вызывать методы управления их свойствами. В тексте программного модуля в качестве названия данного атрибута подставляется идентификатор конкретного элемента диалога, существующего в диалоговом окне формы.

Пример:

// в форме диалога существуют элементы

// НазвФирмы, ИнформПоле, Название

// Поменяем свойства этих элементов диалога

Форма.НазвФирмы.Доступность(0);

Форма.ИнформПоле.Видимость(0);

Форма.Название.Цвет(255, 0, 0);

См. также: Цвет, Видимость, Доступность

Параметр

Параметр, переданный при программном открытии формы.

Синтаксис:

Параметр

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

Parameter

Описание:

Атрибут Параметр объекта «Форма» представляет собой значение, переданное данной форме при ее открытии программно с помощью методов Открытьформу, ОткрытьФормуМодально, ОткрытьПодбор. Если форма открыта интерактивно или если параметр при программном открытии не передавался, то данный атрибут содержит значение неопределенного типа.

Доступ к данному атрибуту возможен только в контексте Модуля формы.

Пример:

ПереданныйПараметр = Форма.Параметр;

См. также: ОткрытьФорму, ОткрытьФормуМодально, ОткрытьПодбор

Методы объекта Форма

При помощи объекта «Форма» предоставляется возможность управлять визуальным представлением текущей формы, опрашивать текущее состояние режима работы формы и т. п.

ТолькоПросмотр

Установка режима редактирования формы,

Синтаксис:

ТолькоПросмотр(<Режим>)

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

Readonly

Параметры:

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

Текущее числовое значение режима редактирования формы (на момент до исполнения метода).

Описание:

Метод ТолькоПросмотр позволяет установить режим редактирования текущей формы.

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

Пример:

Форма.ТолькоПросмотр(0);

Обновить

Обновить форму.

Синтаксис:

Обновись(<Флаг>)

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

Refresh

Параметры:

Описание:

Метод Обновить выполняет обновление окна формы. Кроме того, этот метод позволяет программно установить флаг модифицированности формы. Данный метод имеет смысл вызывать, если через контекст формы (извне, из другого программного модуля) были произведены изменения реквизитов формы.

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

Пример:

Форма.Обновить(1)

См. также: ОткрытьФорму, ОткрытьПодбор, Модифицированность

ИспользоватьЗакладки

Установить режим использования закладок в форме.

Синтаксис:

ИспользоватьЗакладки(<Флаг>)

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

TabCtrlState

Параметры:

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

Текущее значение режима использования закладок формы (на момент до исполнения метода).

Описание:

Метод ИспользоватьЗакладки устанавливает режим использования закладок в форме.

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

Пример:

Форма.ИспользоватьЗакладки(1)

См. также: Закладки, ПриВыбореЗакладки, ИспользоватьСлой

ИспользоватьСлой

Установить режим отображения слоя в форме.

Синтаксис:

ИспользоватьСлой(<ИмяСлоя>, <Режим>)

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

UseLayer

Параметры:

Описание:

Метод Использовать Слой устанавливает режим отображения слоя в форме. Доступ к данному методу возможен только в контексте Модуля формы.

Пример:

Форма.ИспользоватьСлой("Основной, КнопкиДиалога, Дополнительный", 1);

См. также: Закладки, ПриВыбореЗакладки

Заголовок

Установка заголовка окна формы.

Синтаксис:

Заголовок(<Название>, <Режим>)

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

Caption

Параметры:

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

Текущий заголовок окна формы, установленный этой функцией.

Описание:

Метод Заголовок позволяет установить новый заголовок окна формы. Доступ к данному методу возможен только в контексте Модуля формы.

Пример:

Форма.Заголовок("Накладная №" + Док.НомерДок, 0 );

ПанельИнструментов

Управление видимостью панели инструментов окна формы.

Синтаксис:

ПаяельИнструментов(<Режим>)

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

ToolBar

Параметры:

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

Текущее состояние видимости панели инструментов окна формы.

Описание:

Метод ПанельИнструментов предоставляет возможность управления видимостью панели инструментов окна формы.

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

Пример:

Форма.ПанельИнструментов(0);

КнопкаПоУмолчанию

Задает кнопку в форме, которая будет «срабатывать» при нажатии комбинации клавиш Ctrl + Enter.

Синтаксис:

КнопкаПоУмолчанию(<ИдентификаторКнопки>)

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

DefButton

Параметры:

Описание:

Метод КнопкаПоУмолчанию позволяет назначить одну из кнопок формы кнопкой «по умолчанию»: в этом случае нажатие комбинации клавиш Ctrl+Enter приведет к такому же результату, как и нажатие такой кнопки мышью.

В качестве параметра методу передается идентификатор одной из кнопок формы — так, как он указан в палитре свойств соответствующего элемента диалога типа «Кнопка».

Пример:

* В модуле формы документа «ПлатежноеПоручение» кнопкой по умолчанию назначается кнопка с идентификатором " ОК".

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

   Форма.КнопкаПоУмолчанию("ОК");

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

ОбработкаВыбораСтроки

Включает в форме списка обработку выбора строки предопределенной процедурой ПриВыбореСтроки.

Синтаксис:

ОбработкаВыбораСтроки(<Флаг>)

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

ProcessSelectLine

Параметры:

Описание:

Метод ОбработкаВыбораСтроки включает в форме списка (справочника, журнала, счетов, журнала операций, журнала проводок) обработку выбора строки предопределенной процедурой ПриВыбореСтроки.

Доступ к данному методу возможен только в контексте Модуля формы списка.

Пример:

Форма.ОбработкаВыбораСтроки(1)

См. также: ПриВыбореСтроки

ВыполнитьВыбор

Осуществляет выбор из формы подбора.

Синтаксис:

ВыполнитьВыбор(<Знач>)

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

MakeChoise

Параметры:

Описание:

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

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

Пример:

// осуществим выбор в форме журнала документов

Форма.ВыполнитьВыбор(ТекущийДокумент);

РежимВыбора

Возвращает режим работы формы.

Синтаксис:

РежимВыбора()

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

ChoiseMode

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

Число: 0 — форма открыта не для выбора; 1 — форма открыта для выбора одного значения; 2 — форма открыта для выбора нескольких значений.

Описание:

Метод РежимВыбора возвращает режим работы формы. Доступ к данному методу возможен только в контексте Модуля формы.

Пример:

РежимРаботыФормы = Форма.РежимВыбора();

МодальныйРежим

Возвращает режим работы формы.

Синтаксис:

МодальныйРежим()

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

ModalMode

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

Число: 0 — немодальный режим; 1 — модальный режим.

Описание:

Метод МодальныйРежим возвращает режим работы формы. Доступ к данному методу возможен только в контексте Модуля формы.

Пример:

РежимРаботыФормы = Форма.МодальныйРежим();

ПолучитьАтрибут

Получить значение реквизита по имени идентификатора.

Синтаксис:

ПолучитьАтрибут(<ИмяРеквизита>)

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

GetAttrib

Параметры:

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

Значение реквизита <ИмяРеквизита>.

Описание:

Метод ПолучитьАтрибут позволяет получить значение реквизита по имени идентификатора, как оно задано в конфигураторе.

Пример:

ЦенаТов = Форма.ПолучитьАтрибут("ЦенаРозн");

АктивныйЭлемент

Возвращает идентификатор активного элемента диалога.

Синтаксис:

АктивныйЭлемент()

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

ActiveControl

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

Строковое значение — идентификатор активного элемента диалога.

Описание:

Метод АктивныйЭлемент возвращает идентификатор активного элемента диалога.

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

Пример:

ИдАктЭлем = Форма.АктивныйЭлемент();

ТекущаяКолонка

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

Синтаксис:

ТекущаяКолонка()

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

CurrentColumn

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

Строковое значение — идентификатор текущей колонки многострочной части.

Описание:

Метод ТекущаяКолонка возвращает идентификатор текущей колонки многострочной части.

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

Пример:

ИдТекКолонки = Форма.ТекущаяКолонка();

Закрыть

Закрыть форму.

Синтаксис:

Закрыть(<ЗапрСохр>)

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

Close

Параметры:

Описание:

Метод Закрыть закрывает форму. Доступ к данному методу возможен только в контексте Модуля формы.

Замечание. Действие данного метода не прерывает выполнения текущей процедуры программы, т. е. процедура доработает до конца. Данный метод лишь устанавливает признак, который отрабатывает после окончания выполнения процедуры.

Пример:

Форма.Закрыть();

Методы элементов диалога

При помощи атрибута «Форма» средства языка предоставляют возможность программно управлять свойствами элементов диалога. В тексте программного модуля формы через точку после имени атрибута «Форма» можно записывать идентификаторы элементов диалога, а далее через точку можно вызывать методы управления свойствами этих элементов.

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

Видимость

Установка режима отображения.

Синтаксис:

Видимость(<Режим>)

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

Visible

Параметры:

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

Текущее числовое значение режима видимости элемента формы или колонки многострочной части (на момент до исполнения метода).

Описание:

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

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

Пример:

Форма.ИнформПоле.Видимость(0);

Доступность

Установка режима редактирования.

Синтаксис:

Доступность(<Режим>)

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

Enable

Параметры:

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

Текущее числовое значение режима редактирования элемента формы (на момент до исполнения метода).

Описание:

Метод Доступность позволяет установить режим редактирования выбранного элемента формы.

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

Пример:

Форма.НазвФирмы.Доступность(0);

Редактирование

Определяет возможность редактирования значения элемента диалога.

Синтаксис:

Редактирование(<Флаг>)

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

EnableEdit

Параметры:

Описание:

Метод Редактирование определяет возможность редактирования значения непосредственно в элементе диалога для полей ввода типа Число, Строка, Дата, Счет.

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

Пример:

Форма.КолонкаЦены.Редактирование(1);

Цвет

Установка режима отображения цвета.

Синтаксис 1:

Цвет(<Цвет>)

Синтаксис 2:

Цвет(<R>, <G>, <В>)

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

Color

Параметры:

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

Текущее числовое значение RGB-цвета элемента формы (на момент до исполнения метода).

Описание:

Метод Цвет позволяет установить режим отображения цвета выбранного элемента формы.

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

Пример:

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

   Если (Наименование = "") Тогда

      Форма.Название.Цвет(255, 0, 0);

   Иначе

      Форма.Название.Цвет(-1);

   КонецЕсли

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

Маска

Установить/определить маску интерактивного ввода для элементов диалога типа «поле ввода».

Синтаксис:

Маска(<СтрокаМаски>)

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

Mask

Параметры:

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

Строковое значение — текущая маска интерактивного ввода для строковых реквизитов (на момент до исполнения метода).

Описание:

Метод Маска позволяет установить посимвольную маску интерактивного ввода для элементов диалога типа «поле ввода» (аналогично установке в свойствах реквизита диалога в конфигураторе).

В параметре <СтрокаМаски> допустимы следующие символы:

·         ! — введенный символ преобразуется в верхний регистр;

·         9 — произвольный символ цифры;

·         # — произвольный символ цифры или - (знак минус) или + (знак плюс) или пробел;

·         N — любые алфавитно-цифровые символы (буквы или цифры);

·         Х (латинского алфавита) — произвольный символ;

·         @ — любые алфавитно-цифровые символы (буквы или цифры) в верхнем регистре.

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

Пример:

форма.Телефон.Маска("999-99-99");

ВыборГруппы

Установить режим выборки групп для элемента диалога типа «справочник».

Синтаксис:

ВыборГруппы(<Режим>)

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

SelectGroup

Параметры:

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

Текущее числовое значение режима выборки групп для элемента диалога (на момент до исполнения метода).

Описание:

Метод ВыборГруппы устанавливает режим выборки групп для выбранного элемента диалога типа «справочник».

По умолчанию, выборка элементов справочников для реквизитов в формах документов, журналов и справочников установлена без выбора групп, а в форме отчета — с выбором групп. Поэтому реально имеет смысл применять данный метод только в том случае, если надо изменить режим выборки групп.

Особенно необходим данный метод в случае, когда необходимо установить возможность выбора групп в графе табличной части документа.

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

Пример:

* Если в табличной части документа существует какой-либо реквизит, например, «Статус» и необходимо, чтобы он мог принимать значения как элемента, так и группы, то в форме документа этому реквизиту следует установить:

Форма.Статус.ВыборГруппы(1);

ВыполнятьФормулуТолькоПриИзменении

Установка режима выполнения формулы.

Синтаксис:

ВыполнятьФормулуТолькоПриИзменении(<Режим>)

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

ProcessFormulaOnlyWhenChanged

Параметры:

Описание:

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

Пример:

Форма.Цена.ВыполнятьФормулуТолькоПриИзменении(1);

Заголовок

Устанавливает/выдает заголовок элемента диалога.

Синтаксис:

Заголовок(<Название>)

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

Caption

Параметры:

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

Текущий заголовок элемента диалога.

Описание:

Метод Заголовок позволяет установить/прочитать заголовок колонки многострочной части формы, копки, рамки группы, текста, флажка, переключателя.

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

Пример:

Форма.КолонкаЦены.Заголовок("Цена");

УстановитьТип

Установить тип для элемента диалога неопределенного вида.

Синтаксис:

УстановитьТип(<Выражение>)

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

AssignType

Параметры:

Описание:

Метод УстановитьТип позволяет установить тип для элемента диалога, которому в конфигураторе назначен тип «Неопределенный».

Данный метод доступен в контексте Модуля формы (см. «Виды программных модулей»).

Пример:

Форма.ВыбЗнач.УстановитьТип(Товар);

См. также: НазначитьТип, ТипЗначения, ТипЗначенияСтр

НазначитьТип

Назначить тип для элемента диалога неопределенного вида.

Синтаксис:

НазначитьТип(<ИмяТипа>, <Длина>, <Точность>)

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

AssignType

Параметры:

Описание:

Метод НазначитьТип позволяет назначить тип для элемента диалога, которому в конфигураторе назначен тип «Неопределенный».

Данный метод доступен в контексте Модуля формы (см. «Виды программных модулей»).

Пример:

Форма.ВыбКолич.НазначитьТип("Число", 15, 2);

Форма.ВыбДата.НазначитьТип("Дата");

Форма.ВыбТовар.НазначитьТип("Справочник.Товары");

Форма.ВыбДокум.НазначитьТип("Документ");

См. также: УстановитьТип, ТипЗначения, ТипЗначенияСтр

НеИзменятьВид

Позволяет запретить пользователю при выборе значения справочника, документа, счета неопределенного вида изменять вид.

Синтаксис:

НеИзменятьВид(<Признак>)

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

FixKind

Параметры:

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

Число — текущее значение признака.

Описание:

Метод НеИзменятьВид применяется для реквизитов диалога формы, имеющих тип справочника, документа, счета неопределенного вида. Он позволяет запретить при выборе значения изменение вида значения.

Предположим, в диалоге существует реквизит типа справочник неопределенного вида. Вид этого элемента устанавливается при помощи встроенного языка процедурой НазначитьВид. Метод НеИзменятьВид(1) позволяет запретить пользователю при выборе значения выбрать вид справочника.

Пример:

* Например, в некотором документе, для его реквизита «Контрагент» типа справочник неопределенного вида, назначается вид «Организации» или «Сотрудники» и запрещается интерактивное изменение вида пользователем.

Процедура ВводНаОсновании(ДокОсн)

   Если ДокОсн.Вид() = "Счет" Тогда

      НазначитьВид(Контрагент, «Организации»);

   Иначе

      НазначитьВид(Контрагент, «Сотрудники»);

   КонецЕсли;

   Форма.Контрагент.НеИзменятьВид(1);

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

Методы контекста Модуля формы

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

ОткрытьПодбор

Открыть форму для подбора значений.

Синтаксис:

ОткрытьПодбор(<ИмяОбъекта>, <ИмяФормы>, <КонтекстФормы>, <ФлагМножВыбора>,

              <ТекЗнач>)

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

OpenPermanentChoice

Параметры:

Описание:

Метод ОткрытьПодбор, который доступен только в контексте Модуля формы, выполняет открытие формы для подбора значений. Используется, например, для подбора значения реквизита документа.

При открытии подбора по журналу подчиненных документов, т. е. когда первый параметр <ИмяОбъекта> имеет значение "Журнал.Подчиненные", документ владелец, по которому следует построить журнал подчиненных документов, передается после вызова метода через полученный контекст формы.

Пример:

Процедура Подбор()

   ГруппаДляВыбора = ТекущийЭлемент();

   Если ГруппаДляВыбора.ЭтоГруппа() = 0 Тогда

      ГруппаДляВыбора = ГруппаДляВыбора.Родитель;

   КонецЕсли;

   ОткрытьПодбор("Справочник.Товары", "ДляПодбора", КонтПодб, 0);

   // установим в форме подбора реквизит "ГруппаВыбора"

   // используя полученный контекст формы подбора

   КонтПодб.ГруппаВыбора.ВыборГруппы(1);

   КонтПодб.ГруппаВыбора = ГруппаДляВыбора;

   КонтПодб.Обновить(0);

   УстановитьЗначениеВПодборе("ГруппаВыбора", ГруппаДляВыбора);

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

См. также: ОбработкаПодбора, УстановитьЗначениеВПодборе

УстановитьЗначениеВПодборе

Установить значение некоторого реквизита диалога в окне, открытом для подбора значения.

Синтаксис:

УстановитьЗначениеВПодборе(<ИмяРеквизита>, <Значение>)

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

SetValueInPermanentChoice

Параметры:

Описание:

Метод УстановитьЗначениеВПодборе, который доступен только в контексте Модуля формы, используется для того, чтобы в окне диалога, открытом для подбора значения, установить значение некоторого реквизита диалога (он может быть затем использован для отображения некоторой информации в информационных элементах диалога подбора значения).

Данный метод следует использовать после вызова метода ОткрытьПодбор.

Пример:

Процедура Подбор()

   ГруппаДляВыбора = ТекуцийЭлемент();

   Если ГруппаДляВыбора.ЭтоГруппа() = 0 Тогда

      ГруппаДляВыбора = ГруппаДляВыбора.Родитель;

   КонецЕсли;

   ОткрытьПодбор("Справочник.Товары", "ДляПодбора", КонтПодб);

   // установим в форме подбора реквизит "ГруппаВыбора"

   // используя метод УстановитьЗначениеВПодборе

   УстановитьЗначениеВПодборе("ГруппаВыбора", ГруппаДляВыбора);

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

См. также: ОткрытьПодбор, ОбработкаПодбора

ПолучитьЗначениеИзПодбора

Вычислить выражение в контексте открытой формы подбора.

Синтаксис:

ПолучитьЗначениеИзПодбора(<Выражение>)

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

GetValueFromPermanentChoice

Параметры:

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

Значение вычисленного в контексте формы подбора выражения.

Описание:

Метод ПолучитьЗначениеИзПодбора, который доступен только в контексте Модуля формы, позволяет получить результат выражения, выполненного в контексте формы подбора (т. е. получить любые данные из той формы, например выбранный элемент списка справочника подбора значения).

Данный метод следует использовать только после вызова метода ОткрытьПодбор.

Пример:

Процедура ОбработкаПодбора(Выб, Конформы)

   Кол = 0;

   Если ВвестиЧисло(Кол, "Введите количество", 10, 0) = 1 Тогда

      НоваяСтрока();

      ТипPaб = Выб;

      Количество = Кол;

      АктивизироватьСтроку();

      Активизировать("Стоимость", 0);

   КонецЕсли;

   // тип выполненной работы

   ТР = ПолучитьЗначениеИзПодбора("Наименование");

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

См. также: ОткрытьПодбор, ОбработкаПодбора

Активизировать

Установить курсор на выбранный элемент диалога.

Синтаксис:

Активизировать(<ИмяРеквизита>, <Режим>)

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

Activate

Параметры:

Описание:

Метод Активизировать, который доступен только в контексте Модуля формы, устанавливает курсор для редактирования нужного элемента диалога. Например, если необходимо установить курсор на реквизит многострочной части документа (в форме документа) после выхода из предопределенной процедуры ОбработкаПодбора.

Метод Активизировать может быть вызван из другого (внешнего) модуля, если в нем известен контекст формы, в которой нужно активизировать элемента диалога.

Пример:

См. предыдущий пример.

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

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

Синтаксис:

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

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

ActivateObj

Параметры:

Описание:

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

Пример:

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

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

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

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

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

ПриОткрытии

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

Синтаксис:

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

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

OnOpen

Описание:

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

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

Пример:

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

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

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

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

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

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

Синтаксис:

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

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

OnReopen

Описание:

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

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

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

Пример:

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

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

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

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

ПриЗакрытии

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

Синтаксис:

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

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

OnClose

Описание:

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

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

Пример:

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

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

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

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

   КонецЕсли;

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

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

ПриВыбореЗакладки

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

Синтаксис:

ПриВыбореЗакладки(<НомерЗакладки>, <Значение3акладки>)

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

OnTabCtrlPosChanged

Параметры:

Описание:

Вызов предопределенной процедуры ПриВыбореЗакладки производится в системе 1С:Предприятие неявно в момент интерактивного выбора пользователем закладки в форме. При вызове процедуры, система подставляет фактические значения параметров, характеризующие выбранную закладку.

Параметры <НомерЗакладки> и <Значение3акладки> используется в теле процедуры для обработки передаваемого системой события смены закладки формы.

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

Пример:

Процедура ЗакладкаОбщиеВидимость(ФлагВидимости)

   Форма.Название.Видимость(ФлагВидимости);

   Форма.Наименование.Видимость(ФлагВидимости);

   Форма.Код.Видимость(ФлагВидимости);

   Форма.Статус.Видимость(ФлагВидимости);

   Форма.Адрес.Видимость(ФлагВидимости);

   Форма.Телефон.Видимость(ФлагВидимости);

   Активизировать("Наименование", 0);

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

Процедура ЗакладкаЗаметкиВидимость(ФлагВидимости)

   Форма.Заметки.Видимость(ФлагВидимости);

   Активизировать("Заметки", 0);

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

Процедура ПриВыбореЗакладки(НомерЗакладки, ЗначениеЗакладки)

   Если Значение3акладки = 1 Тогда

      Закладка.Заметки.Видимость(0);

      Закладка.Общие.Видимость(1);

   ИначеЕсли ЗначениеЗакладки = 2 Тогда

      Закладка.Общие.Видимость(0);

      Закладка.Заметки.Видимость(1);

   КонецЕсли;

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

См. также: ИспользоватьЗакладки, Закладки, СтатусВозврата

ПриНачалеВыбораЗначения

Предопределенная процедура при начале выбора значения.

Синтаксис:

ПриНачалеВыбораЗначения(<ИдентЭлемДиалога>, <ФлагСтанд06р>)

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

OnStartValueChoice

Параметры:

Описание:

Вызов предопределенной процедуры ПриНачалеВыбораЗначения производится в системе 1С:Предприятие неявно в момент, когда в форме пользователь интерактивно инициировал выбор значения (выбор может быть интерактивно инициирован в немодальном режиме при помощи элемента диалога с кнопкой выбора или клавишей «F4»). При вызове процедуры, система подставляет фактические значения параметров, характеризующие элемент диалога и флаг стандартной обработки.

Замечание. В теле этой процедуры методы ОткрытьФорму и ОткрытьПодбор работают для выбора.

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

Пример:

Процедура ПриНачалеВыбораЗначения(Элемент, Флаг)

   Перем КонтПодб;

   Если Элемент = "ИдВыбКлиент" Тогда

      Флаг = 0;

      ОткрытьПодбор("Справочник.Клиенты", "ДляПодбора", КонтПодб);

   КонецЕсли;

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

ОбработкаПодбора

Предопределенная процедура обработки подбора значения.

Синтаксис:

ОбработкаПодбора(<ЗначениеПод6ора>, <КонтФормы>)

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

ProcessPermanentChoice

Параметры:

Описание:

Вызов предопределенной процедуры ОбработкаПодбора производится в системе 1С:Предприятие неявно после нажатия кнопки «Выбрать» в форме подбора значения (см. метод ОткрытьПодбор). В этот момент система подставляет фактическое значение параметра <ЗначениеПодбора>.

Формальный параметр <ЗначениеПодбора> используется в теле процедуры для приема и обработки передаваемого системой значения элемента подбора.

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

Пример:

Процедура ОбработкаПодбора(Знач, КонтФормы)

   НоваяСтрока();

   Товар = Знач;

   Знач.ИспользоватьДату(ДатаДок);

   Цена = Знач.Цена;

   Сообщить(Знач.Цена);

   Сообщить(Знач.МОЛ.Наименование);

   АктивизироватьСтроку();

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

См. также: ОткрытьПодбор

ОбработкаВыбораЗначения

Предопределенная процедура обработки выбора значения.

Синтаксис:

ОбработкаВыбораЗначения(<Вы6Знач>, <ИдентЭлемДиалога>, <ФлагСтандОбр>)

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

ProcessPermanentChoice

Параметры:

Описание:

Вызов предопределенной процедуры ОбработкаВыбораЗначения производится в системе 1С:Предприятие неявно, после выбора значения в форм⁶ выбора (выбор может быть инициирован в немодальном режиме интерактивно, при помощи элемента диалога с кнопкой выбора). В момент выбора система автоматически подставляет фактическое значение параметра <Вы6Знач>.

Формальный параметр <ВыбЗнач> используется в теле процедуры для приема и обработки передаваемого системой выбранного значения.

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

Пример:

Процедура ОбработкаВыбораЗначения(Знач, Идент, Флаг)

   ...

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

ПриВыбореСтроки

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

Синтаксис:

ПриВыбореСтроки()

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

OnSelectLine

Описание:

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

Замечание: Режим обработки выбора строки (двойной щелчок мыши или клавиша Enter) предопределенной процедурой ПриВыбореСтроки включается в форме списка справочника, журнала, счетов, журнала операций, журнала проводок при помощи метода Форма.ОбработкаВыбораСтроки(1)

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

Пример:

Процедура ПриВыбореСтроки()

   Если НазваниеНабораПрав() = "Продавец" Тогда

      Предупреждение("У вас нет права просмотра строки!", 2);

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

   КонецЕсли;

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

См. также: СтатусВозврата, ОбработкаВыбораСтроки

Атрибуты и методы контекста Модуля формы отчета (обработки)

Таблица

Объект агрегатного типа «Таблица».

Синтаксис:

Таблица

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

Table

Описание:

Атрибут Таблица (только для чтения) представляет собой ссылку на объект типа «Таблица». Доступ к данному атрибуту возможен только в контексте Модуля формы отчета или обработки. При настройке формы отчета (обработки), если табличный документ размещен непосредственно в форме (для этого в диалоге, вызываемом пунктом «Свойства формы» меню «Действия» в параметре «Использовать таблицу» выбирается вариант «Пустую» или «Для ввода данных»), то доступ к такому объекту осуществляется через атрибут контекста формы отчета (обработки) Таблица.

Атрибуты и методы объекта «Таблица» описаны в разделе «Работа с таблицами» и позволяют в программном модуле управлять процессом формирования и визуального отображения таблицы в целом, а также изменять свойства визуального отображения отдельных областей таблицы.

В тексте программного модуля через точку после имени атрибута «Таблица» можно записывать адреса областей таблицы, а далее через точку можно вызывать методы управления свойствами этих областей.

Пример:

Таблица.ИсходнаяТаблица("price");

Таблица.Вывести();

Таблица.ТолькоПросмотр(0);

Таблица.Показать("Каталог", "Catalog.mxl");

Таблица.ТолькоПросмотр(1);

Пример:

ВыбОбласть = Таблица.Область("R8C4");

ВыбОбласть.Шрифт("Arial");

ВыбОбласть.РазмерШрифта(10);

ВыбОбласть.Подчеркнутый(1);

ВыбОбласть.ГоризонтальноеПоложение(3);

ВыбОбласть.Контроль(4);

ВыбОбласть.ЦветФона(34, 126, 211);

См. также: разд. «Работа с таблицами»

<ИмяОбласти>

Возвращает или задает значение, записанное в именованной области таблицы в режиме ввода данных.

Синтаксис:

Описание:

Атрибут <ИмяОбласти> позволяет обращаться к значениям, записанным в поименованных областях таблицы в режиме ввода данных. Для обращения к значению конкретной области следует указать имя этой области, заданный в конфигураторе.

Данный атрибут существует и доступен в форме, если при конфигурировании данной формы в свойствах формы выбраны опция «Использовать таблицу» — «Для ввода данных». Установка данной опции в свойствах формы означает наличие у данной формы таблицы в режиме ввода данных. В процессе конфигурирования в таблице можно задать любое число выделенных и поименованных областей.

Доступ к данному атрибуту возможен только в контексте Модуля формы отчета или обработки.

Замечание: Данный атрибут работает на чтение только в том случае, если в качестве области таблицы помечена одна единственная ячейка.

Пример:

* В диалоге формы есть элемент диалога ВыбКод. В форме использована таблица в режиме ввода данных. Одна из ячеек таблицы помечена как область с именем «ВыбранныйКлиент». В этом случае в модуле формы можно задать значение данной области.

Клн = СоздатьОбъект("Справочник.Клиенты");

Клн.НайтиПоКоду(ВыбКод, 0);

ВыбранныйКлиент = Клн.ТекущийЭлемент();

См. также: разд. «Работа с таблицами»

РасположениеФайла

Определить, где располагается данный внешний отчет.

Синтаксис:

РасположениеФайла(<Путь>, <Имя>)

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

FilePath

Параметры:

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

Строковое значение полного имени (вместе с путем) файла, где располагается данный внешний отчет.

Описание:

Метод РасположениеФайла позволяет узнать, где располагается данный внешний отчет.

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

Пример:

Имя = "";

Путь = "";

ПолноеИмя = РасположениеФайла(Путь, Имя);

Предопределенные процедуры модуля формы отчета (обработки)

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

ВводНового

Предопределенная процедура при открытии формы отчета (обработки) или при восстановлении сохраненной настройки отчета (обработки).

Синтаксис:

ВводНового()

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

InputNew

Описание:

При работе с формой отчета у пользователя существует возможность сохранять и восстанавливать настройки отчета — содержимое реквизитов диалога формы. Предопределенная процедура ВводНового вызывается и в вомент открытия формы и в момент восстановления значений настройки. Это позволяет контролировать содержимое реквизитов диалога во всех случаях их изменения системой.

Пример:

Процедура ВводНового()

   ДатаНач = РабочаяДата();

   ДатаКон = РабочаяДата();

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

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

ПриОткрытии

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

Синтаксис:

ПриОткрытии(<ФлагЧтенияНастройки>)

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

OnOpen

Параметры:

Описание:

Форма любого отчета или обработки в системе 1С:Предприятие обязательно содержит экранный диалог. В диалоге могут размещаться элементы для задания различных параметров построения отчета или выполнения обработки. При Использовании отчета (обработки) набор параметров, использованных при формировании отчета или выполнения обработки, можно запомнить, а при следующем использовании этого же отчета (обработки) — восстановить. Для выполнения этих операций существуют команды в меню «Действия» системы 1С:Предприятие.

Набор параметров формирования отчета или выполнения обработки называется настройкой отчета (обработки). Последняя сохраненная настройка автоматически восстанавливается системой 1С:Предприятие, при вызове отчета (обработки).

Вызов предопределенной процедуры ПриОткрытии производится самой системой 1С:Предприятие неявно при интерактивном открытии отчета (обработки). Параметр <ФлагЧтенияНастройки> позволяет определить, была ли при открытии отчета (обработки) восстановлена сохраненная настройка.

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

Пример:

Процедура ПриОткрытии(ФлагСохрНастр)

   Если ФлагСохрНастр = 0 Тогда

      ВыбВалюта = Константа.ОснВалюта;

   КонецЕсли;

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

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

---

---