Просмотр исходного текста страницы Компоненты редактора форм

Как и при редактировании сценариев, свойства элементам назначаются с помощью [[Инспектор объектов|инспектора объектов]]. Нажмите F11 или дважды щелкните по любому элементу в дизайнере форм, чтобы отобразить его на экране, если он скрыт. Выделите нужный элемент, и в инспекторе объектов вы увидите все присущие ему свойства. Чтобы выделить объект – щелкните мышью в любой точке его зоны в поле формы. Чтобы выделить группу, щелкните на ее названии. 



===Группа===
[[Файл:cl_cc_scr_i71.png|left]] 



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



'''Свойства''':

{|cellpadding="10" cellspacing="0" border="1"
|Идентификатор
|Текст. Используется для идентификации группы в групповых запросах
|-
|Заголовок
|Текст, отображающийся сверху. При сворачивании группы виден только заголовок.
|-
|Развернута по умолчанию
|Флаг, определяющий формат начального отображения. В случае установки, при открытии окна оператор не видит элементов группы, и ему необходимо развернуть ее для работы с ней. Имеет смысл при использовании более чем одной группы для упрощения начального восприятия оператором формы ввода.
|-
|Запрет сворачивания
|Флаг, определяющий, сможет ли оператор по своему усмотрению свернуть группу при необходимости.
|-
|Размер шрифта
|Число в диапазоне 7 - 20. Задает размер шрифта в пикселях текста заголовка группы, заколовков, подписей, комментариев и содержимого всех элементов группы. 
|-
|Значения 
|Запрос SQL, обращающийся к идентификаторам всех элементов, принадлежащих web-форме. Осуществляет множественное чтение данных из элементов для сохранения в БД. Если у некоторого элемента назначено свойство «Сохранение», будет выполнено и индивидуальное и групповое сохранение.
|-
|Сохранение
|Запрос SQL, обращающийся к идентификаторам всех элементов, принадлежащих группе. Осуществляет множественное чтение данных из элементов для сохранения в БД.
|} 


При групповой загрузке и сохранении, использующихся в группе, существует доступ к значениям элементов из других групп. Для этого в тексте запроса необходимо явно вписать «[IdGroup].[IdElement]».



[[Файл:cl_cc_scr_i72.png|left]]
===Метка===



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

 

Свойства:

 

Идентификатор
 Текст. Используется для идентификации метки в групповых запросах
 
Отступ слева
 Число. Задает расстояние ( в пикселях ) от метки до левой границы формы
 
Переносить текст
 Флаг, определяющий  вариант переноса текста в метке. Если флаг установлен, то текст, который не поместился по ширине в пределах ячейки будет перенесен на следующие строки. Если флаг не установлен, то текст , который не поместился в одну строку будет заменен многоточием.
 
Текст
 Аргумент, значение которого после вычисления подставляется в метку. Может быть 

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных
 
 

 

 

 

 Линия

 

Линия представляет собой простой горизонтальный разграничитель зон внутри группы. Свойств не имеет.

 

 

 

 Текстовое поле

 



 

Элемент в зависимости от настроек может выглядеть по-разному. Настройками определяются смещения по горизонтали, разнос на несколько строк, наличие заголовка, подписи, комментария, наличие галочки, а также количество строк в поле ввода. Основное назначение – ввод или ввод/вывод текстовой информации. Все прочие компоненты имеют ту же структуру (группировку) элементарных объектов, формирующих элемент управления диалоговой формы. Это:

 

· заголовок (текстовое значение); 

· подпись (текстовое значение); 

· комментарий (текстовое значение); 

· галочка, блокирующая элемент управления (числовое значение: 0 – не установлена, любое другое число – установлена ); 

· поле ввода ( текстовое значение ) 

 

Любой из дополнительных объектов можно скрыть. Значения для галочки и поля ввода доступны для загрузки всеми способами, описанными выше, значения остальных объектов задаются  задаются константами. Возможность сохранения имеют галочка и поле ввода.

 

Свойства:

 

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

· фиксированный отступ означает, что элемент будет отображен на расстоянии от левой границы формы равном настройке «Отступ слева». Если перед элементом имеется заголовок, то его ширина будет изменена, а текст который не поместился будет заменен многоточием 

· отступ за текстом позиционирует элемент сразу после текста заголовка, если заголовок размещен слева, работает аналогично фиксированному отступу, если заголовок расположен сверху
 
 
Отступ слева
 Число. Задает расстояние ( в пикселях ) от элемента до левой границы формы. Настройка игнорируется, если заголовок расположен слева и выбран тип отступа «За текстом».
 
Размер
 Флаг, определяющий способ задания размера.

· фиксированный - ширина элемента определяется настройкой «Ширина». 

· растянутый - элемент растягивается по ширине до размеров ячейки. В случае изменения размеров формы ширина контрола будет изменяться автоматически.
 
 
Ширина
 Число.  Задает ширину элемента ( в пикселях ). Настройка игнорируется, если выбран размер «растянутый».
 
Кол-во строк
 Число. Задает количество текстовых строк в элементе
 
Тип маски
 Устанавливает ограничение на вводимую в поле информацию и способ отображения

· отсутствует 

· простой 

· числовой 

· регулярные выражения 

· упрощенные регулярные выражения
 
 
Маска ввода
 Действует только при установке «типа маски» в значения «простой» или «регулярные выражения».

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

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных
 
 
Сохранение
 Набор настроек, определяющих способы сохранения заданного пользователем значения элемента. Настройки задаются с помощью формы сохранения
 
Заголовок
 Аргумент, значение которого после вычисления подставляется в заголовок элемента. Может быть только константой. Заголовок в зависимости от настройки «Расположение заголовка» может располагаться над текстовым полем или слева от него. В качестве значения аргумента может быть задана пустая строка. В этом случае заголовок будет отсутствовать.
 
Расположение заголовка
 Флаг, определяющий расположение заголовка.

· сверху - заголовок будет располоен над текстовым полем 

· слева - заголовок будет расположен перед текстовым полем
 
 
Подпись
 Аргумент, значение которого после вычисления подставляется в подпись элемента. Может быть только константой. В качестве значения аргумента может быть задана пустая строка. В этом случае подпись будет отсутствовать. Рекомендуется в качестве подписи не использовать строки большой длины.
 
Комментарий
 Аргумент, значение которого после вычисления подставляется в комментарий элемента. Может быть только константой. В качестве значения аргумента может быть задана пустая строка. В этом случае комментарий будет отсутствовать.
 
Переносить текст
 Флаг, определяющий  вариант переноса текста в заголовке и комментарии элемента. Если флаг установлен, то текст, который не поместился по ширине в пределах ячейки будет перенесен на следующие строки. Если флаг не установлен, то текст , который не поместился в одну строку будет заменен многоточием. На текст, содержащийся в подписи элемента, установка флага не влияет.
 
Наличие галочки
 Флаг, определяющий наличие галочки перед элементом.
 
Значение галочки
 Целочисленный аргумент, значение которого после вычисления подставляется в текстовое поле. Может быть 

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных
 
 
Обязательно для заполнения
 Флаг, определяющий необходимость ввода текста в поле ввода. Если флаг установлен, то в момент выполнения сценария кнопка «Далее» диалоговой формы будет недоступна до тех пор, пока не будет заполнено это поле. Флаг игнорируется, если элемент был заполнен при загрузке формы. Если настроено отображение галочки, то заполнение поля требуется лишь при ее активации.
 

 

 

 

 Выпадающий список

 

Элемент в зависимости от настроек принимает разные формы и служит для различных целей. Основное отличие – возможность выбора значения из динамически формируемого списка. Настройками определяются смещения по горизонтали, наличие заголовка, подписи, комментария, наличие галочки, а также возможность редактирования. Элементом списка является пара (идентификатор, отображаемая строка), где идентификатор может принимать значение любого типа. При загрузке формы перечень возможных значений в список может быть загружен произвольной комбинацией вариантов: константы, значения переменных, выражения, а также запросы SQL, возвращающие выборку данных содержащую идентификаторы значений и их текстовые представления. Загрузка текущего активного значения происходит из произвольного источника (константа, переменная, поле прикрепленной таблицы, выражение, индивидуальный запрос SQL, групповой запрос SQL) и сопоставляется с загруженными элементами списка по соответствию идентификаторов. При сохранении значения также используется идентификатор элемента списка.

Свойства элемента «Выпадающий список» и всех последующих элементов по большей части аналогичны свойствам элемента «Текстовое поле», поэтому описания будут приводится только для основных свойств.

 

Основные свойства:

 

Идентификатор
 Текст. Используется для идентификации выпадающего списка в групповых запросах
 
Редактировать
 Флаг, определяющий возможность редактирования значения элемента. Если флаг установлен, то список может использоваться аналогично элементу «Текстовое поле», в противном случае выбрать значение можно только из списка элементов, определенных в настройке «Элементы»
 
Значение
 Аргумент типа «строка», «число», «Дата и время», значение которого после вычисления подставляется в индекс списка. Может быть 

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных 

В случае, если значение аргумента отсутствует в списке вычисленных индексов коллекции элементов, список в зависимости от настройки «Редактировать» будет отображать перый элемент из коллекции, либо оставаться пустым.
 
Элементы
 Коллекция, элементы которой после вычисления значений всех её аргументов будут использованы в качестве элементов выпадающего списка. Настройки задаются с помощью формы элементов
 
Сохранение
 Набор настроек, определяющих способы сохранения выбранного пользователем индекса элемента. Настройки задаются с помощью формы сохранения
 
Отображать в статистике
 Флаг, определяющий - будет ли выбранное или введенное пользователем значение элемента доступно для модуля статистики.
 
Обязательно для заполнения
 Флаг, определяющий необходимость ввода текста в поле или выбора одного из элемнтов списка. Если флаг установлен, то в момент выполнения сценария кнопка «Далее» диалоговой формы будет недоступна до тех пор, пока не будет заполнено это поле или выбран элемент списка. Флаг игнорируется, если элемент был заполнен при загрузке формы. Если настроено отображение галочки, то заполнение поля требуется лишь при ее активации.
 

 

 

 Галочка

 

Служит для выбора одного из двух вариантов. В качестве значения при загрузке и сохранении принимает числа «0» и «1». Загрузка осуществляется из произвольного источника, сохранение также произвольно. Свойства элемента в целом аналогичны свойствам элемента «Метка».

 

Основные свойства:

 

Идентификатор
 Текст. Используется для идентификации галочки в групповых запросах
 
Значение галочки
 Аргумент, значение которого после вычисления подставляется в значение галочки. Может быть 

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных
 
 
Сохранение
 Набор настроек, определяющих способы сохранения заданного пользователем значения галочки. Настройки задаются с помощью формы сохранения
 
Отображать в статистике
 Флаг, определяющий - будет ли выбранное или введенное пользователем значение галочки доступно для модуля статистики.
 

 

 Дата/время

 

Элемент предоставляет в зависимости от настроек возможность выбора даты, времени, интервала дат и интервала времен внутри дня. Настройками определяются смещения по горизонтали, наличие заголовка, подписи, комментария, наличие галочки. Основное назначение – ввод или ввод/вывод временной информации. Загрузка осуществляется из произвольных источников (константа, переменная, поле прикрепленной таблицы, выражение, индивидуальный запрос SQL, групповой запрос SQL). Сохранение также произвольно.

 

Основные свойства:

 

Идентификатор
 Текст. Используется для идентификации поля дата/время в групповых запросах
 
Значение1
 Аргумент типа «строка», «Дата и время», значение которого после вычисления подставляется:

· в качестве значения поля, если настройка «Тип» установлена в «Фиксированная дата» 

· в качестве значения нижней границы интервала дат, если настройка «Тип» установлена в «Интервал». 

Может быть:

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных
 
 
Значение2
 Аргумент типа «строка», «Дата и время», значение которого после вычисления:

· не используется, если настройка «Тип» установлена в «Фиксированная дата» 

· подставляется в качестве значения верхней границы интервала дат, если настройка «Тип» установлена в «Интервал». 

Может быть 

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных
 
 
Сохранение1
 Набор настроек, определяющих способы сохранения заданного пользователем значения элемента:

· значения поля, если настройка «Тип» установлена в «Фиксированная дата» 

· значения нижней границы интервала дат, если настройка «Тип» установлена в «Интервал» 

Настройки задаются с помощью формы сохранения
 
Сохранение2
 Набор настроек, определяющих способы сохранения заданного пользователем значения элемента:

· значения поля, если настройка «Тип» установлена в «Фиксированная дата» 

· значения верхней границы интервала дат, если настройка «Тип» установлена в «Интервал» 

Настройки задаются с помощью формы сохранения
 
Отображать в статистике
 Флаг, определяющий - будет ли выбранное или введенное пользователем значение элемента доступно для модуля статистики.
 
Обязательно для заполнения
 Флаг, определяющий необходимость ввода текста в поле элемента. Если флаг установлен, то в момент выполнения сценария кнопка «Далее» диалоговой формы будет недоступна до тех пор, пока не будет заполнено это поле. Флаг игнорируется, если элемент был заполнен при загрузке формы. Если настроено отображение галочки, то заполнение поля требуется лишь при ее активации. Если настроено отображение галочки, то заполнение поля требуется лишь при ее активации.
 

 

 

 

 Спин (числовой ввод)

 

Элемент предоставляет несколько способов визуального представления. Помимо основного элемента управления в компоненте «Спин» настройками определяются смещения по горизонтали, разнос, наличие заголовка, подписи, комментария, наличие галочки. Основное назначение – ввод или ввод/вывод целочисленной информации. Загрузка осуществляется из произвольных источников (константа, переменная, поле прикрепленной таблицы, выражение, индивидуальный запрос SQL, групповой запрос SQL). Сохранение также произвольно.

 

Основные свойства:

 

Идентификатор
 Текст. Используется для идентификации спина в групповых запросах
 
Минимальное значение
 Аргумент типа «число» значение которого после вычисления подставляется в качестве нижней границы диапазона значений спина.

Может быть:

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных
 
 
Максимальное значение
 Аргумент типа «число» значение которого после вычисления подставляется в качестве верхней границы диапазона значений спина.

Может быть:

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных
 
 
Значение
 Аргумент типа «число» значение которого после вычисления подставляется в качестве значения спина.

Может быть:

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных
 
 
Сохранение1
 Набор настроек, определяющих способы сохранения заданного пользователем значения спина. Настройки задаются с помощью формы сохранения
 
Отображать в статистике
 Флаг, определяющий - будет ли выбранное или введенное пользователем значение элемента доступно для модуля статистики.
 
Обязательно для заполнения
 Флаг, определяющий необходимость ввода текста в поле элемента. Если флаг установлен, то в момент выполнения сценария кнопка «Далее» диалоговой формы будет недоступна до тех пор, пока не будет заполнено это поле. Флаг игнорируется, если элемент был заполнен при загрузке формы. Если настроено отображение галочки, то заполнение поля требуется лишь при ее активации. Если настроено отображение галочки, то заполнение поля требуется лишь при ее активации.
 

 

 

 Группа опций

 

Позволяет реализовать выбор одного из перечисленных вариантов на основе элементов «радио». Настройками определяются смещения по горизонтали, разнесение на несколько столбцов, наличие заголовка, подписи, комментария. Основное назначение – ввод или ввод/вывод целочисленной информации. Загрузка значения осуществляется из произвольных источников (константа, переменная, поле прикрепленной таблицы, выражение, индивидуальный запрос SQL, групповой запрос SQL). Также произвольным образом загружаются перечни значений. Это может быть любая комбинация из константных элементов и элементов, определяемых запросами. Каждый элемент представляет собой идентификатор и подпись. Идентификатор это числовое значение. 

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

 

Основные свойства:

 

Идентификатор
 Текст. Используется для идентификации группы опций в групповых запросах
 
Число столбцов
 Число. Определяет количство столбцов в группе опций.
 
Значение
 Аргумент типа «строка», «число», значение которого после вычисления устанавливает индекс выбранного элемента группы. Может быть 

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных 

В случае, если значение аргумента отсутствует в списке вычисленных индексов коллекции элементов, в группе не будет выбрана ни одна опция
 
Элементы
 Коллекция, элементы которой после вычисления значений всех её аргументов будут использованы в качестве элементов группы опций. Настройки задаются с помощью формы элементов
 
Сохранение
 Набор настроек, определяющих способы сохранения выбранного пользователем индекса элемента. Настройки задаются с помощью формы сохранения
 
Отображать в статистике
 Флаг, определяющий - будет ли выбранное или введенное пользователем значение элемента доступно для модуля статистики.
 
Обязательно для заполнения
 Флаг, определяющий необходимость выбора одной из опций. Если флаг установлен, то в момент выполнения сценария кнопка «Далее» диалоговой формы будет недоступна до тех пор, пока не будет выбрана одна из опций. Флаг игнорируется, если опция была выбрана при загрузке формы. Если настроено отображение галочки, то выбор элемента требуется лишь при ее активации.
 

 

 

 Группа галок

 

Позволяет реализовать выбор нескольких из перечисленных вариантов на основе элементов «галочка». Настройками определяются смещения по горизонтали, разнесение на несколько столбцов, наличие заголовка, подписи, комментария. Основное назначение – ввод или ввод/вывод целочисленной информации. Загрузка осуществляется из произвольных источников (константа, переменная, поле прикрепленной таблицы, выражение, индивидуальный запрос SQL, групповой запрос SQL). Сохранение также произвольно. В качестве выходного значения принимается битовая маска в строковом или числовом виде (0001011101). Отсчет идет с начала в случае строкового значения, но с конца (с нулевого бита) в случае целочисленного. Целочисленное значение может быть сохранено в базе для последующего анализа в отчетах, а также арифметическими операциями обработано в сценарии.

 

Основные свойства:

 

Идентификатор
 Текст. Используется для идентификации группы галок в групповых запросах
 
Число столбцов
 Число. Определяет количство столбцов в группе галок.
 
Значение
 Аргумент типа «строка», «число», значение которого после вычисления устанавливает бинарную маску выбранных элементов группы. Может быть 

· константой; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных 

В случае, если значение аргумента отсутствует в списке вычисленных индексов коллекции элементов, в группе не будет выбрана ни одна галка
 
Элементы
 Коллекция, элементы которой после вычисления значений всех её аргументов будут использованы в качестве элементов группы галок. Настройки задаются с помощью формы элементов
 
Сохранение
 Набор настроек, определяющих способы сохранения выбранных пользователем индексов элемента. Настройки задаются с помощью формы сохранения
 
Отображать в статистике
 Флаг, определяющий - будет ли выбранное или введенное пользователем значение элемента доступно для модуля статистики.
 
Обязательно для заполнения
 Флаг, определяющий необходимость выбора одной из галок. Если флаг установлен, то в момент выполнения сценария кнопка «Далее» диалоговой формы будет недоступна до тех пор, пока не будет выбрана одна из галок. Флаг игнорируется, если галки были выбраны при загрузке формы. Если настроено отображение галочки, то заполнение поля требуется лишь при ее активации.
 

 

 

 Изображение

 

Позволяет отобразить любую картинку, пиктограмму, фотографию и прочие графические данные. Информация об изображении может быть передана статически из прикрепленного файла (например, логотип компании – заказчика кампании), может быть динамически подгружен по переданному пути из размещенных на сервере графических файлов, а также получен как image-поток из базы данных. Изменения изображений не предусмотрено. Изображение может быть размещено в его реальных размерах или сжато до фиксированного размера. Также доступна фиксация только высоты или только ширины для сохранения пропорций изображения.

 

Основные свойства:

 

Идентификатор
 Текст. Используется для идентификации элемента «Изображение» в групповых запросах
 
Тип отображения
 Число. Определяет способ отображения элемента на форме:

· «по размеру рисунка» - элемент принимает размеры рисунка 

· «фиксированный» - элемент в качестве размеров использует настройки «Ширина» и «Высота» 

· «фиксированная высота» - элемент в качестве высоты использует настройку «Высота», ширина изображения вычисляется пропорционально размерам рисунка, настройка «Ширина» игнорируется 

· «фиксированная ширина» - элемент в качестве ширины использует настройку «Ширина», высота изображения вычисляется пропорционально размерам рисунка, настройка «Высота» игнорируется 

· «растянутый» - элемент в качестве ширины использует ширину ячейки, высота вычисляется пропорционально размерам рисунка, настройки «Ширина» и  «Высота» игнорируются
 
 
Ширина
 Число, определяющее ширину изображения
 
Высота
 Число, определяющее высоту изображения
 
Изображение
 Аргумент, значение которого после вычисления устанавливает источник изображения для элемента. Может быть 

· константой - путь к файлу с рисунком; 

· переменной сценария; 

· полем прикрепленной к задаче таблицы; 

· выражением 

· запросом SQL в базу данных. Запрос может возвращать путь к файлу с рисунком, либо рисунок в бинарном формате. 
 
 

 

 

 Таблица (grid)

 

Позволяет отобразить данные из множества, возвращаемого отдельным запросом SQL. Настройками определяются высота, ширина, а также столбцы с указанием соответствия столбцам выборки. Все поля выборки приводятся к текстовому виду. Таблица служит только для отображения информации, изменения данных не предусмотрено.

 

Основные свойства:

 

Идентификатор
 Текст. Используется для идентификации элемента «Таблица» в групповых запросах. В текущей версии это свойство не используется
 
Ширина
 Число, определяющее ширину таблицы
 
Высота
 Число, определяющее высоту таблицы
 
Значения
 Аргумент, значение которого после вычисления устанавливает источник данных для таблицы. Может быть запросом SQL в базу данных. Запрос должен возвращать набор данных ( recordset ).
 
Столбцы
 Коллекция, элементы которой после вычисления значений всех её аргументов будут использованы в качестве параметров столбцов таблицы. Настройки задаются с помощью формы «Столбцы таблицы»
 

 

 

 Кнопка

 

Позволяет реализовать переключение на заданный номер. Настройками определяются надпись на кнопке, номер (внешний или внутренний), но который должно быть выполнено переключение. Кнопка служит только для переключения на внешний или внутренний номер, привязка других обработчиков не предусмотрена.

 

Основные свойства:

 

Идентификатор
 Текст. Используется для идентификации элемента «Кнопка» в групповых запросах. 
 
Ширина
 Число, определяющее высоту таблицы
 
Надпись на кнопке
 Аргумент, значение которого после вычисления подставляется в текст надписи на кнопке. 
 
Номер
 Аргумент, значение которого после вычисления используется в качетсве номера для переключения.