Формы

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

Функции

    ОбновитьФорму
    ОбновитьФормуЗаголовока
    ОчиститьФормуЗаголовка
    ОчиститьФормуНаСекции
    ПолучитьФормуЗаголовка
    ПолучитьФормуНаСекции
    СоздатьФорму
    ТекущаяФормаВДизайнере

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

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

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

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

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


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

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


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

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


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

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


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

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


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

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


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

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

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

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

включить "Формы";
переменные
  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'); 
  для делать
  начало
   .Лево := 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.