3.1.3.10. TbtkLookUpDBChartFrame#

3.1.3.10.1. Общие положения#

class btkFrame.TbtkLookUpDBChartFrame#

Фрейм предназначен для отображения данных в виде графиков.

3.1.3.10.2. Режимы построения#

“Стандартный”: Количество графиков фиксировано и определяется в свойствах фрейма. Для каждого графика необходимо указать атрибуты, содержащие значения по осям X и Y. Все параметры графика задаются свойствами фрейма.
“Одноколоночный”: Количество графиков может изменяться. Выборка должна содержать минимум 3 атрибута, содержащих значения по осям X и Y и системное имя графика, к которому относятся эти значения. То есть, значения точек по осям X и Y всех графиков хранятся в 2-х атрибутах. Список серий и свойств серий может быть запрошен отдельным запросом - “Выборкой серий”. Также возможно задать допустимые значения по оси X с помощью “Выборки значений оси X”.

3.1.3.10.3. Свойства фрейма#

Системное имя свойства	Описание	Поддержка в AS
Группа “Выборка значений оси Х”
`XValuesSelection.LabelField`	Атрибут с подписями значений по оси X	+
`XValuesSelection.XValueField`	Атрибут со значениями по оси X	+
`XValuesSelection`	Системное имя выборки допустимых значений оси X	+
Группа “Выборка серий”
`SeriesSelection.SeriesGroupField`	Атрибут с номером группы серии	-
`SeriesSelection.AxisField`	Атрибут с указанием оси Y	-
`SeriesSelection.SeriesParamsField`	Атрибут со свойствами серии	-
`SeriesSelection.SeriesTypeField`	Атрибут с типом серии	-
`SeriesSelection.PointerParamsField`	Атрибут со свойствами точек серии	-
`SeriesSelection`	Системное имя выборки серий	+
`SeriesSelection.NameField`	Атрибут с системным именем серии	-
`SeriesSelection.CaptionField`	Атрибут с наименованием серии	-
Группа “График”
`ChartTitle`	Основной заголовок графика	-
`CHARTSTYLE`	Режим построения графика	+
`ChartTitles`	Наименования серий	+
`AllowSettings`	Возможность сохранения настроек	-
`ShowMarks`	Отображение подписей к данным	+
`Use3D`	3-х мерные графики	-
`CommandBarVisible`	Отображать панель инструментов графика	-
`ShowLegend`	Отображать легенду	+
Группа “Данные”
`ChartCount`	Количество серий	+
`YValuesFields`	Атрибут(ы) со значениями по оси Y	+
`XValuesFields`	Атрибут(ы) со значениями по оси X	+
`ChartCaptionField`	Атрибут с наименованием серии	+
`ChartTypeField`	Атрибут с типом серии	+
`ChartNumField`	Атрибут с системным именем серии	+
`CaptionsFields`	Атрибут(ы) с подписями значений	+
`ChartTypes`	Типы серий	+
Группа “Оси”
`XTitle`	Наименование оси X	+
`XAxisLables`	Вид подписей по оси X	+
`YAxisLables`	Вид подписей по оси Y	+
`YAxis.YIsDateTime`	Значения оси Y являются датой	+
`XAxis.XIsDateTime`	Значения оси X являются датой	+
`YTitle`	Наименование оси Y	+
Группа “Точки серий”
`Points.Visible`	Точки - Видимость	-
`Points.Style`	Точки - Вид	-
`Points.MovementStyle`	Точки - Возможность перетаскивания	-
`Points.ShowPointHint`	Отображать значение при наведении курсора	-
`Points.RoundValue`	Точки - При перетаскивании округлять значение	-

3.1.3.10.4. Детальные настройки графиков#

Кнопка “Тип серий” позволяет изменить тип всех отображаемых на графике серий. Кнопка “Редактирование” открывает окно детальных настроек графика в общем и серий по отдельности. Заданные настройки можно сохранять (если установлено свойство AllowSettings) и загружать отдельно. Изначально сохраненные настройки персональны. Их можно сделать общими, и они будут доступны для всех пользователей. Также можно задать “настройку по умолчанию”. Она будет автоматически загружаться при открытии фрейма.

Warning

В AS данный функционал не реализован

3.1.3.10.5. События фрейма#

OnSeriesClick: Вызывается при нажатии на серию графика.

Warning

В AS это событие не реализовано

OnSeriesDoubleClick: Вызывается при двойном нажатии на серию графика.

Warning

В AS это событие не реализовано

3.1.3.10.6. Настройка контекстного меню серий#

Если в выборке имеется операция “ChartPopupMenu”, то она вместе с подчинёнными операциями будет отображаться в выпадающем меню при клике правой кнопкой на какую-либо серию.

Warning

В AS данный функционал не реализован

3.1.3.10.7. Скриптер#

Доступ к компоненту “График” из скриптера осуществляется через объект TCustomChart. Его можно получить, используя метод TbtkScriptSelectionObject.Chart либо его “быстрый” аналог TatInternalObject.Chart.

Warning

В AS данный функционал не реализован

Объект TCustomChart позволяет следующее:

сохранять и загружать детальные настройки графика
управлять видимостью и содержимым заголовка графика
управлять видимостью и заголовками осей графика

Пример#

<pascal>
  Chart.BottomAxis.Title.Caption := 'Нижняя ось';

  Selection.Chart.BottomAxis.Title.Caption := 'Нижняя ось';

  S := FindSelection('SEL_AnyName');
  S.Chart.BottomAxis.Title.Caption := 'Нижняя ось';
</pascal>