1.2.13. TbtkLookUpDBChartFrame¶

1.2.13.1. Общие положения¶

class btkFrame.TbtkLookUpDBChartFrame¶

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

Доступные типы графиков:

Линейный

Диаграмма Гантта

Столбчатые диаграммы (вертикальная и горизонтальная)

Круговые диаграммы

Пузырьковые диаграммы

Точки

Области

1.2.13.2. Режимы построения¶

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

1.2.13.3. Свойства фрейма¶

Системное имя свойства	Описание
Группа “Выборка значений оси Х”
`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`	Точки - При перетаскивании округлять значение до:
`Points.Size`	Точки - Размер (в пикселах)

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

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

1.2.13.5. События фрейма¶

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

1.2.13.6. Настройка контекстного меню серий¶

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

1.2.13.7. Скриптер¶

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

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

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

Пример¶

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

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

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

1.2.13.8. Известные проблемы¶

При работе с графиком на 5-м клиенте может валиться ошибка «Некорректное значение параметра. Имя параметра: "Points.RoundValue"».

Для исправления надо зайти в зарегистрированные свойства и для свойства Points.RoundValue указать значение через запятую вместо точки.