Модуль "Формы"

Функции

Объекты и типы

Функции модуля "Формы"

ОбновитьФорму

Формат вызова:
ОбновитьФорму(НаСекции, ССекции: целое); /*только чтение*/

ОбновитьФормуЗаголовока

Формат вызова:
ОбновитьФормуЗаголовока; /*только чтение*/

ОчиститьФормуЗаголовка

Формат вызова:
ОчиститьФормуЗаголовка; /*только чтение*/

ОчиститьФормуНаСекции

Формат вызова:
ОчиститьФормуНаСекции(Секция: целое); /*только чтение*/

ПолучитьФормуЗаголовка

Формат вызова:
ПолучитьФормуЗаголовка: Форма; /*только чтение*/

ПолучитьФормуНаСекции

Формат вызова:
ПолучитьФормуНаСекции(Секция: целое): Форма; /*только чтение*/

СоздатьФорму

Формат вызова:
СоздатьФорму: Форма; /*только чтение*/

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

пример использования:

включить "Формы";
переменные
  i          : целое;  
  Ф          : Форма;
  E1,E2,E3,B : ЭлементФормы;
начало
  Ф := СоздатьФорму;
  E1 := Ф.СоздатьЭлемент('TSectionEditor', 'Edit1'); 
  E1.Ширина := 40;
  E2 := Ф.СоздатьЭлемент('TSectionEditor', 'Edit2');
  E2.Лево := 50; E2.Ширина := 40;
  E3 := Ф.СоздатьЭлемент('TSectionEditor', 'Edit3'); 
  E3.Лево := 170; E3.Ширина := 40;
  E1.Текст := '10'; E2.Текст := '20'; E3.Текст := '';
  B := Ф.СоздатьЭлемент('TButton', 'Button'); 
  для B делать
  начало
   .Лево := 100;
   .Текст  := 'Сложить'; 
   .Ширина := 60;
   .Узлы.Содержимое := {
   включить "Формы";
   Выполнение(Элемент: ЭлементФормы);
   переменные
   a, b: целое;
   начало
   a := СтрокаВЦелое(Элемент.Форма.Элемент("Edit1").Текст);
   b := СтрокаВЦелое(Элемент.Форма.Элемент("Edit2").Текст);
   Элемент.Форма.Элемент("Edit3").Текст := ЦелоеВСтроку(a + b);
   конец  
  };
  конец;
//  i := Ф.Показать('Форма', Кнопка_Да + Кнопка_Нет);
  i := Ф.Показать('Форма', Нет)  
конец  

ТекущаяФормаВДизайнере

Формат вызова:
ТекущаяФормаВДизайнере: строка; /*только чтение*/

Типы модуля "Формы"

Форма

функции объекта:

Высота

Формат вызова:
Форма.Высота: целое;

описание:
Получает/устанавливает высоту формы.

ЗагрузитьИзКонфигурации

Формат вызова:
Форма.ЗагрузитьИзКонфигурации(Название: строка); /*только чтение*/

описание:
Загружает представление формы из Конфигурации.

Изменена

Формат вызова:
Форма.Изменена: целое;

описание:
Получает/устанавливает признак изменения характеристик формы. При присваивании Да, форма перерисовывается, внесённые изменения вступают в силу.

Имя

Формат вызова:
Форма.Имя: строка; /*только чтение*/

описание:
Выдает имя формы, под которым она сохранена в конфигурации.

КнопкаДиалога

Формат вызова:
Форма.КнопкаДиалога(Кнопка: целое): строка;

описание:
Позволяет установить/получить надписи на кнопках диалога.

пример использования:

включить "Формы";
переменные
  Ф          : Форма;
  i            : целое;
...
  Ф.КнопкаДиалога(Кнопка_Да) := 'Yes';
  Ф.КнопкаДиалога(Кнопка_Нет):= 'No';
...
  i := Ф.Показать('Форма', Кнопка_Да + Кнопка_Нет);
...

Показать

Формат вызова:
Форма.Показать(Заголовок: строка; Кнопки: целое): целое; /*только чтение*/

описание:
Отображает окно, соответствующее форме.

Скрипт

Формат вызова:
Форма.Скрипт: Программа; /*только чтение*/

СоздатьЭлемент

Формат вызова:
Форма.СоздатьЭлемент(Тип, Имя: строка): ЭлементФормы; /*только чтение*/

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

Узлы

Формат вызова:
Форма.Узлы: СтруктурныйСписок; /*только чтение*/

описание:
Позволяет обращаться к форме, как к структурному списку.

Ширина

Формат вызова:
Форма.Ширина: целое;

описание:
Получает/устанавливает ширину формы.

Элемент

Формат вызова:
Форма.Элемент(Имя: строка): ЭлементФормы; /*только чтение*/

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

ЭлементФормы

описание:
Существуют предопределенные константы для обозначения типов элементов формы.
ТипЭлемента_Группа - "TCategoryPanel",
ТипЭлемента_ГруппаПризнаков - "TRadioGroup",
ТипЭлемента_Группы - "TCategoryPanelGroup",
ТипЭлемента_Закладка - "TTabPagePanel",
ТипЭлемента_Закладки - "TTabbedPages",
ТипЭлемента_Картинка - "TImage",
ТипЭлемента_Кнопка - "TButton",
ТипЭлемента_Метка - "TLabel",
ТипЭлемента_Панель - "TGradientPanel",
ТипЭлемента_Признак - "TSectionCheckBox",
ТипЭлемента_Рамка - "TBevel",
ТипЭлемента_Редактор - "TSectionEditor",
ТипЭлемента_Секция - "TSectionPanel",
ТипЭлемента_Список - "TListBox",
ТипЭлемента_Текст - "TMemo",
ТипЭлемента_Фигура - "TShape".

функции объекта:

АвтоРазмер

Формат вызова:
ЭлементФормы.АвтоРазмер: целое;

описание:
Для некоторых визуальных элементов формы размер может изменяться. Например TLabel с пустым текстом практически не занимает места в горизонтальном направлении и расширяется в зависимости от длины текста, если АвтоРазмер установлен в Да. Однако, если АвтоРазмер = Нет и Ширина элемента присвоено некоторое значение, то текст будет размещаться на элементе не полностью, если ширины не достаточно для его размещения.

АктивнаяЗакладка

Формат вызова:
ЭлементФормы.АктивнаяЗакладка: целое;

описание:
Получает/устанавливает номер активной закладки на элементе формы типа TTabbedPages

Верх

Формат вызова:
ЭлементФормы.Верх: целое;

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

Видимость

Формат вызова:
ЭлементФормы.Видимость: целое;

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

ВидимостьСтраницы

Формат вызова:
ЭлементФормы.ВидимостьСтраницы: целое;

ВписатьВРазмер

Формат вызова:
ЭлементФормы.ВписатьВРазмер: целое;

Выбор

Формат вызова:
ЭлементФормы.Выбор: целое;

описание:
Для эелемента формы с типом TClientRadioGroup позволяет определить сделанный выбор. От 0 для количества вариантов - 1.

ВыбраннаяСтрока

Формат вызова:
ЭлементФормы.ВыбраннаяСтрока: строка; /*только чтение*/

ВыбранныйИндекс

Формат вызова:
ЭлементФормы.ВыбранныйИндекс: целое; /*только чтение*/

Выравнивание

Формат вызова:
ЭлементФормы.Выравнивание: целое;

описание:
Получает/устанавливает тип выравнивания текста для визуального элемента формы, например для TLabel. Типы выравнивания: ВыравниваниеТекста_Лево, ВыравниваниеТекста_Центр, ВыравниваниеТекста_Право.

Высота

Формат вызова:
ЭлементФормы.Высота: целое;

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

Градиент

Формат вызова:
ЭлементФормы.Градиент: целое;

Доступность

Формат вызова:
ЭлементФормы.Доступность: целое;

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

Заголовок

Формат вызова:
ЭлементФормы.Заголовок: строка;

Захлопнут

Формат вызова:
ЭлементФормы.Захлопнут: целое;

Изменен

Формат вызова:
ЭлементФормы.Изменен: целое;

описание:
Получает/устанавливает признак изменения элемента формы. Присваивание вида: Форма.Элемент("Имя_Элемента").Изменен := Да; приводит к визуальному обновлению элемента.

Имя

Формат вызова:
ЭлементФормы.Имя: строка;

описание:
Получает/устанавливает имя элемента формы.

ИмяШрифта

Формат вызова:
ЭлементФормы.ИмяШрифта: строка;

описание:
Получает/устанавливает имя шрифта для элемента формы.

Картинка

Формат вызова:
ЭлементФормы.Картинка: целое;

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

Кликнуть

Формат вызова:
ЭлементФормы.Кликнуть([Признак]: строка); /*только чтение*/

описание:
Выполняет программное "нажатие" ("клик") на элементе формы.

Лево

Формат вызова:
ЭлементФормы.Лево: целое;

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

Метка

Формат вызова:
ЭлементФормы.Метка: целое;

Обработчик

Формат вызова:
ЭлементФормы.Обработчик: строка;

ОчиститьЭлементы

Формат вызова:
ЭлементФормы.ОчиститьЭлементы; /*только чтение*/

Параметр

Формат вызова:
ЭлементФормы.Параметр(Имя: строка): строка;

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

пример использования:

Элемент Edit2 имеет тип TSectionEditor, в дизайн-тайм свойство "Редактор" (EditStyle) у него не установлено. Следующие строки превращают его в ComboBox.

  Ф.Элемент("Edit2").Список := "99
999
9999
99999";
  Ф.Элемент("Edit2").Параметр("EditStyle") := "список";

ПереносПоСловам

Формат вызова:
ЭлементФормы.ПереносПоСловам: целое;

описание:
Разрешает (Да) или запрещает (Нет) перенос текста по словам в элементе формы, например типа TLabel.

Переход

Формат вызова:
ЭлементФормы.Переход: целое;

Подсказка

Формат вызова:
ЭлементФормы.Подсказка: строка;

описание:
Получает/устанавливает текст подсказки (hint'a) для элемента формы.

ПоказатьПодсказку

Формат вызова:
ЭлементФормы.ПоказатьПодсказку: целое;

описание:
Разрешает/запрещает показывать подсказку (hint) для элемента формы.

ПоказатьТекст

Формат вызова:
ЭлементФормы.ПоказатьТекст: целое;

Положение

Формат вызова:
ЭлементФормы.Положение: целое;

описание:
Получает/устанавливает положение элемента формы относительно родительского элемента. Варианты: Положение_нет, Положение_верх, Положение_низ, Положение_целиком, Положение_лево, Положение_право.

ПоЦентру

Формат вызова:
ЭлементФормы.ПоЦентру: целое;

Предыдущий

Формат вызова:
ЭлементФормы.Предыдущий: ЭлементФормы; /*только чтение*/

ПрозрачныйФон

Формат вызова:
ЭлементФормы.ПрозрачныйФон: целое;

Прокрутка

Формат вызова:
ЭлементФормы.Прокрутка: целое;

ПустоТекст

Формат вызова:
ЭлементФормы.ПустоТекст: строка;

РазмерОтступа

Формат вызова:
ЭлементФормы.РазмерОтступа: целое;

РазмерТекста

Формат вызова:
ЭлементФормы.РазмерТекста([Текст]: строка): РазмерТекста; /*только чтение*/

РазмерШрифта

Формат вызова:
ЭлементФормы.РазмерШрифта: целое;

описание:
Получает/устанавливает размер шрифта, используемого в элементе формы.

Рамка

Формат вызова:
ЭлементФормы.Рамка: целое;

описание:
Получает/устанавливает признак: рамка есть/ рамки нет.

РамкаСтиль

Формат вызова:
ЭлементФормы.РамкаСтиль: целое;

описание:
Получает/устанавливает стиль рамки. Существуют стили: СтильРамки_ВФокусе, СтильРамки_Выделенный, СтильРамки_Нормальный, СтильРамки_Прозрачный.

РамкаФорма

Формат вызова:
ЭлементФормы.РамкаФорма: целое;

описание:
Получает/устанавливает форму рамки. Варианты: ФормаРамки_Контур, ФормаРамки_ЛинияСверху, ФормаРамки_ЛинияСлева, ФормаРамки_ЛинияСнизу, ФормаРамки_ЛинияСправа, ФормаРамки_Рамка.

Родительский

Формат вызова:
ЭлементФормы.Родительский: ЭлементФормы; /*только чтение*/

СкосВнутри

Формат вызова:
ЭлементФормы.СкосВнутри: целое;

описание:
Устанавливает или получает характер внутреннего скоса некоторых элементов формы (например типа TListBox). Варианты: Скос_Вогнутый, Скос_Выпуклый, Скос_Ровный, Скос_Нет.

СкосСнаружи

Формат вызова:
ЭлементФормы.СкосСнаружи: целое;

описание:
Устанавливает или получает характер наружного скоса некоторых элементов формы (например типа TListBox). Варианты: Скос_Вогнутый, Скос_Выпуклый, Скос_Ровный, Скос_Нет.

СкосТип

Формат вызова:
ЭлементФормы.СкосТип: целое;

описание:
Устанавливает тип скоса элемента формы. Варианты: СкосТип_нет, СкосТип_плитка, СкосТип_плавный, СкосТип_плоский.

СкосШирина

Формат вызова:
ЭлементФормы.СкосШирина: целое;

описание:
Устанавливает толщину скоса.

Скрипт

Формат вызова:
ЭлементФормы.Скрипт(Имя: строка): строка;

Следующий

Формат вызова:
ЭлементФормы.Следующий: ЭлементФормы; /*только чтение*/

СобытиеРедактора

Формат вызова:
ЭлементФормы.СобытиеРедактора: строка;

Создать

Формат вызова:
ЭлементФормы.Создать(Тип, Имя: строка): ЭлементФормы; /*только чтение*/

Список

Формат вызова:
ЭлементФормы.Список: строка;

описание:
Получает/устанавливает список значений для элемента формы. Например для элемента формы типа TSectionEditor (с редактором "список") можно установить список следующим образом:
Форма.Элемент("Имя_Элемента").Список := 'Первый\ nВторой\ nТретий\ nЧетвертый';

пример использования:

  lb := Ф.Элемент("ListBox");
  lb.Список := 'Первый\ nВторой\ nТретий\ nЧетвертый\ nПятый';
// Конечно же между "\" и "n" пробела не должно быть! :)

СписокЗначений

Формат вызова:
ЭлементФормы.СписокЗначений(Фиксированный: целое): Список; /*только чтение*/

Ссылка

Формат вызова:
ЭлементФормы.Ссылка: целое;

СтильГраницы

Формат вызова:
ЭлементФормы.СтильГраницы: целое;

описание:
Получает/устанавливает стиль границы элемента формы. Да (1) - линия, Нет (0) - нет выделенной границы.

СтильШрифта

Формат вызова:
ЭлементФормы.СтильШрифта: целое;

описание:
Получает/устанавливает стиль шрифта элемента формы. Стили: Шрифт_Жирный, Шрифт_Зачеркнутый, Шрифт_Наклонный, Шрифт_Подчеркнутый.

Таблица

Формат вызова:
ЭлементФормы.Таблица: СтатическиеДанные;

Текст

Формат вызова:
ЭлементФормы.Текст: строка;

описание:
Получает/Устанавливает текст компонента. Например текст на кнопке (TButton) или на метке (TLabel).

Тень

Формат вызова:
ЭлементФормы.Тень: целое;

Тип

Формат вызова:
ЭлементФормы.Тип: строка;

описание:
Получает/устанавливает тип элемента формы. Например: TLabel, TSectionButton, и др.

ТипФигуры

Формат вызова:
ЭлементФормы.ТипФигуры: целое;

описание:
Получает/устанавливает тип фигуры элемента формы TShape. Имеются константы для обозначения типа фигуры: ТипФигуры_квадрат, ТипФигуры_Круг, ТипФигуры_Прямоугольник, ТипФигуры_СкругКвадрат, ТипФигуры_СкругПрямоугольник, ТипФигуры_Эллипс.

ТолщинаЛинии

Формат вызова:
ЭлементФормы.ТолщинаЛинии: целое;

ТолькоЧтение

Формат вызова:
ЭлементФормы.ТолькоЧтение: целое;

Удалить

Формат вызова:
ЭлементФормы.Удалить; /*только чтение*/

Узлы

Формат вызова:
ЭлементФормы.Узлы: СтруктурныйСписок; /*только чтение*/

Фон

Формат вызова:
ЭлементФормы.Фон: целое;

описание:
Получает/устанавливает цвет фона элемента формы.

Форма

Формат вызова:
ЭлементФормы.Форма: Форма; /*только чтение*/

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

Цвет

Формат вызова:
ЭлементФормы.Цвет: целое;

ЦветЗаливки

Формат вызова:
ЭлементФормы.ЦветЗаливки: целое;

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

ЦветЛинии

Формат вызова:
ЭлементФормы.ЦветЛинии: целое;

описание:
Получает/устанавливает цвет линии.

ЦветРодителя

Формат вызова:
ЭлементФормы.ЦветРодителя: целое;

ЦветШрифта

Формат вызова:
ЭлементФормы.ЦветШрифта: целое;

описание:
Получает/устанавливает цвет шрифта элемента формы.

Чекнут

Формат вызова:
ЭлементФормы.Чекнут: целое;

описание:
Позволяет проверить/установить состояние таких элементов формы как TSectionCheckBox и TRadioButton.

ЧислоСтолбцов

Формат вызова:
ЭлементФормы.ЧислоСтолбцов: целое;

описание:
Число столбцов в элементе формы типа TClientRadioGroup.

ЧислоЭлементов

Формат вызова:
ЭлементФормы.ЧислоЭлементов: целое; /*только чтение*/

описание:
Получает число элементов формы принадлежащих элементу формы (расположенных на элементе формы).

Ширина

Формат вызова:
ЭлементФормы.Ширина: целое;

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

ШиринаБордюра

Формат вызова:
ЭлементФормы.ШиринаБордюра: целое;

Элемент

Формат вызова:
ЭлементФормы.Элемент(Значение: БезТипа; [Признак]: строка): ЭлементФормы; /*только чтение*/

ЭлементМеню

Формат вызова:
ЭлементФормы.ЭлементМеню: ЭлементФормы; /*только чтение*/

Якоря

Формат вызова:
ЭлементФормы.Якоря: целое;

описание:
Получает/устанавливает якорные привязки визуального элемента формы относительно родительского элемента формы. По умолчанию устанавливается в Якорь_лево+Якорь_верх. Якорь_лево = 1, Якорь_верх=2, Якорь_право=4, Якорь_низ=8.