1.5.3. Диалоговые элементы (Объект Форма)

1.5.3.1. Создание диалоговых элементов формы.

Диалоговые элементы создаются в визуальном редакторе форм конфигуратора путем выбора доступного элемента из панели инструментов и размещения его на форме (см. Рис.1). 

Рис.1 Элементы в панели инструментов формы конфигуратора.

В дальнейшем настроить диалоговый элемент можно в окне свойств диалогового элемента (см. Рис.2).

Рис.2 Свойства диалогового элемента "флажок".

1.5.3.2. Виды диалоговых элементов.

Ниже перечислены доступные на текущий момент виды диалоговых элементов в порядке их расположения на панели инструментов формы (Рис.1):

-Флажок (переключатель типа "выключено", "включено");

-Переключатель (радиокнопка);

-Кнопка;

-Список;

-Поле со списком;

-Рамка;

-Надпись;

-Поле редактирования;

-Сетка (элемент для представления таблицы)*;

-Дерево (элемент для представленя дерева значений)*;

-Прогресс-бар;

-Слайдер;

-Микроформа;

-Закладки.

Замечание:
Элементы, отмеченные (*) более детально рассмотрены в других разделах документации. 

1.5.3.3. Программное управление диалоговыми элементами.

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

1.5.3.4. Общие методы атрибутов формы.

Активизировать(), Activate

Назначение: Установить фокус на указанный диалоговый элемент формы

Параметры: нет

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

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

Назначение: Получить/установить видимость диалогового элемента на форме

Параметры: <Режим> - 1 установить видимость, 0 - сделать элемент невидимым

Возвращаемое значение: значение на момент исполнения метода

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

Назначение: Получить/установить доступность элемента для интерактивного редактирования

Параметры: <Режим> - 1 установить доступность, 0 - сделать элемент недоступным для редактирования

Возвращаемое значение: значение на момент исполнения метода

Заголовок(<ИмяЗаголовка>), Caption

Назначение: Позволяет получить/установить свойство Заголовок элемента формы.

Параметры: <ИмяЗаголовка> - строка, новое значение свойства Заголовок.

Возвращаемое значение: значение на момент исполнения метода

Модифицированность(<Флаг>), Modify

Назначение: Получить/установить флаг модифицированности диалогового элемента на форме

Параметры: <Флаг> - 1 элемент изменялся, 0 - элемент не изменялся

Возвращаемое значение: значение на момент исполнения метода

ПолучитьКоординаты(<Лево>,<Верх>,<Ширина>,<Высота>), GetControlRect

Назначение: Получить координаты диалогового элемента относительно верхнего левого угла формы

Параметры: 

<Лево>, <Верх>, <Ширина>, <Высота>- переменные, в которые будут возвращены соответствующие значение координат диалогового элемента на форме 

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

УстановитьКоординаты(<Лево>,<Верх>,<Ширина>,<Высота>), SetControlRect

Назначение: Установить координаты диалогового элемента относительно верхнего левого угла формы

Параметры: 

<Лево>, <Верх>, <Ширина>, <Высота>- новые координаты диалогового элемента на форме 

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

Пример:

Лево=0;

Верх=0;

Ширина=0;

Высота=0;

Форма.Таблица.ПолучитьКоординаты(Лево,Верх,Ширина,Высота);

//Переместим в левый верхний угол

Форма.Таблица.УстановитьКоординаты(0,0,Ширина,Высота);

1.5.3.5. Дополнительные методы атрибутов формы.

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

Назначение: установить маску ввода диалогового элемента Поле редактирования

Параметры: <Строка> - маска ввода

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

Редактирование(<Режим>), EnableEdit

Назначение: Определяет возможность непосредственного редактирования значения в элементе Поле редактирования для типов Число, Строка, Дата.

Параметры: <Режим> - 1 значение редактируется как обычно, 0 - значение не редактируется, но может выбираться кнопкой выбора. Метод Доступность(0) отключает также и кнопку выбора.

Возвращаемое значение: значение на момент исполнения метода

ПолучитьСвойствоМикроформы(<ИмяСвойства>), GetPropertyMicroForm

Назначение: Получить предварительно установленное значение дополнительного свойства элемента Микроформа

Параметры: <ИмяСвойства> - имя свойства микроформы

Возвращаемое значение: значение свойства микроформы

ДобавитьСвойствоМикроформы(<ИмяСвойства>,<ЗначПоУмолчанию>,<Тип>,<Длина>), AddPropertyMicroForm

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

Параметры:

<ИмяСвойства> - имя свойства микроформы

<ЗначПоУмолчанию> - значение свойства по умолчанию

<Тип> - тип значения свойства. Возможные значения:

- "Число";

- "Строка";

- "Цвет";

- "Событие";

- "ТипЗначения";

- "Переменная".

<Длина> - максимальная длина значения свойства 

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

Замечание:
Данный метод вызывается в модуле общей формы, добавляемой на другую форму в качестве микроформы . 

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

Назначение: Позволяет получить/установить свойство Цвет элемента формы Надпись.

Параметры: <Цвет> - число, цвет в формате RGB.

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

Цвет(<R>,<G>,<B>), Color

Назначение: Позволяет получить/установить свойство Цвет элемента формы Надпись.

Параметры: <R>, <G>,<B>- численные значения цвета для красной, зеленой и синей составляющей.

Возвращаемое значение: значение на момент исполнения метода

1.5.3.6. Свойства и методы объекта Форма.

Программный доступ к свойствам формы диалога в целом осуществляется в модуле формы с помощью конструкции Форма.<ИмяСвойстваИлиМетода>. 

Предопределенные свойства:

- Параметр - при вызове формы в него передаются необходимые входные параметры;

- Закладки - список значений, в котором значениями являются имена слоев формы, а представлениями - имя закладки.

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

Замечание:
При использовании общей формы в  качестве Микроформы для нее будут работать также  методы атрибутов формы, описанные выше. 

Закрыть(), Close

Назначение: закрыть форму.

Параметры: нет.

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

ПолучитьАтрибут(<ИмяАтрибута>), GetAttribut

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

Параметры: <ИмяАтрибута> - имя атрибута.

Возвращаемое значение: значение атрибута.

УстановитьАтрибут(<ИмяАтрибута>,<Значение>), SetAttribut

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

Параметры:

<ИмяАтрибута> - имя атрибута.

<Значение> - значение атрибута.

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

ПолучитьКоличествоАтрибутов(), GetAttributCount

Назначение: получить количество атрибутов формы.

Параметры: нет.

Возвращаемое значение: количество атрибутов формы.

ПолучитьИмяАтрибута(<Номер>), GetAttributName

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

Параметры: <Номер> -  порядковый номер атрибута.

Возвращаемое значение: имя атрибута.

Обновить(), Refresh

Назначение: обновить изображения диалоговых элементов формы после внесения программных изменений.

Параметры: нет.

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

ОбновитьВыражения(), RefreshExpr

Назначение: обновить диалоговые элементы формы, рассчитываемые с помощью выражений .

Параметры: нет.

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

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

Назначение: определяет использование закладок формы.

Параметры: <Флаг> 1-использовать закладки, 0-не использовать.

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

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

Назначение: определяет видимость слоя формы.

Параметры: 

<ИмяСлоя> - определенное в конфигураторе имя слоя формы

<Режим> - 1 - слой видим, 0 - нет

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

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

Назначение: назначить кнопку по умолчанию.

Параметры: <Идентификатор> - идентификатор кнопки.

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

АктивныйЭлемент(<Идентификатор>), ActiveControl

Назначение: установить фокус на диалоговый элемент с указанным идентификатором.

Параметры: <Идентификатор> идентификатор активизированного диалогового элемента.

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

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

Назначение: получить режим открытия формы.

Параметры: нет.

Возвращаемое значение: 1 - форма открыта в модальном режиме, 0 - нет.

РежимВыбора(<Флаг>), ChoiceMode

Назначение: получить/установить режим подбора для формы.

Параметры: <Флаг> - 1 - установить режим подбора; 0 - сбросить режим подбора .

Возвращаемое значение: значение до исполнения метода.

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

Назначение: выбрать значение в форму из которой открыт подбор.

Параметры: <Значение>.

Возвращаемое значение: зависит от реализации метода "ОбработкаПодбора" родительского контекста.

РасположениеФайла(), FilePath

Назначение: получить строку полного пути к внешней форме.

Параметры: нет.

Возвращаемое значение: строка, указывающая полный путь к форме.

ТекстМодуля(), ModuleText

Назначение: получить текст модуля формы в строку.

Параметры: <Значение>.

Возвращаемое значение: строка, содержащая текст модуля формы.

ТекстФормы(), FormText

Назначение: получить описания свойств диалоговых элементов формы в строку.

Параметры: нет.

Возвращаемое значение: строка, содержащая текст описания свойств диалоговых элементов формы.

Замечание:
Формат описания таков, что с помощью системной функции ЗначениеИзСтроки(СтрокаТекстаФормы) можно получить структуру, содержащую свойства диалоговых элементов формы . 

ТекстОписания(), DescriptionText

Назначение: получить текст страницы "Описание" формы в строку.

Параметры: нет.

Возвращаемое значение: строка, содержащая текст страницы "Описание" формы.

ТекстОписания(), DescriptionText

Назначение: получить текст страницы "Описание" формы в строку.

Параметры: нет.

Возвращаемое значение: строка, содержащая текст страницы "Описание" формы.

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

Назначение: определяет возможность обработки выбора строки в формах списков.

Параметры: <Флаг> - 1-разрешить обработку выбора строки, 0 - запретить .

Возвращаемое значение: значение до исполнения метода.

ТекущийЭлемент(<Значение>), CurrentValue

Назначение: получить/установить текущее значение подбора.

Параметры: <Значение> - новое значение подбора.

Возвращаемое значение: значение подбора до исполнения метода.