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

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

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

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

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

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

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

Пример:

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

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

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

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

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

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

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

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

Иначе

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

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

Форма

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

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

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

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

Пример:

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

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

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

Закладки

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

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

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

Пример:

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

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

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

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

КонецЕсли;

Иначе

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

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

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

КонецЕсли;

КонецЕсли;

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

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

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

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

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

Пример:

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

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

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

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

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

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