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

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

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

Видимость

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

Синтаксис:

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

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

Visible

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: 1 — элемент диалога отображается; 0 — элемент диалога скрыт (невидим).

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

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

Описание:

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

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

Пример:

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

Доступность

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

Синтаксис:

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

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

Enable

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: 1 — разрешено редактирование элемента формы; 0 — запрещено редактирование.

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

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

Описание:

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

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

Пример:

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

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

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

Синтаксис:

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

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

EnableEdit

Параметры:

<Флаг>

Число: 1 — значение элемента редактируется как обычно; 0 — значение не редактируется но может выбираться кнопкой выбора. Отличие от метода Доступность в том, что Доступность отключа­ет и кнопку выбора.

Описание:

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

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

Пример:

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

Цвет

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

Синтаксис 1:

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

Синтаксис 2:

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

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

Color

Параметры:

<Цвет>	Необязательный параметр. Числовое выражение, значение которого задает RGB цвет. Допустимые значения от 0 до 16'777'215. Значение -1 (минус единица) задает цвет, задан­ный для всей формы по умолчанию.
<R>	Числовое выражение, значение которого задает красную компоненту цвета. Допустимые значения от 0 до 255.
<G>	Числовое выражение, значение которого задает зеленую компоненту цвета. Допустимые значения от 0 до 255.
<В>	Числовое выражение, значение которого задает синюю ком­поненту цвета. Допустимые значения от 0 до 255.

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

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

Описание:

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

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

Пример:

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

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

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

Иначе

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

КонецЕсли

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

Маска

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

Синтаксис:

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

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

Mask

Параметры:

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

Необязательный параметр. Строковое выражение — посимвольная маска интерактивного ввода для стро­ковых реквизитов диалога (аналогично установке в свойствах реквизита диалога в конфигураторе).

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

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

Описание:

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

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

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

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

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

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

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

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

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

Пример:

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