Xy-столбчатая диаграмма
XY-Столбчатая диаграмма представляет элементы данных (X, Y) в виде прямоугольных столбцов. |
|
XY-Столбчатая диаграмма основана на координатной области построения и координатном отрисовщике. Она наследует все их свойства.
XY-Столбчатая диаграмма выглядит следующим образом:
XY-Столбчатая диаграмма поддерживает три отрисовщика:
Простой
"Классический" отрисовщик столбцов.
Приведенный ниже пример использует ось дат в качестве оси х.
Составной отрисовщик
Отрисовщик для отображения столбцов графика стеками на координатной области построения.
Все серии данных должны использовать одни и те же значения х, чтобы значения отображались стеками.
Кластерный отрисовщик
Данный отрисовщик немного отличается от простого тем, что он настраивает положение и ширину каждого столбца, помещая столбцы всех серий данных в пределах одного интервала х.
Приведенный ниже пример использует ось дат в качестве оси х.
Массив данных
XY-Столбчатая диаграмма поддерживает несколько моделей данных:
Имеет следующие привязки исходных данных:
Привязка | Тип ожидаемого значения | Описание |
Серия | строка | Текстовое имя серии данных, представленной на графике в виде линии (или набора фигур). |
X | число | Точка привязки столбца вдоль оси определений (Х). Не используется, если Фактор выравнивания столбца является отрицательным. Для более подробной информации обратитесь к разделу Фактор выравнивания столбцов. |
Нижнее X значение | число | Нижняя граница столбца вдоль оси определений (Х) или часть ширины столбца. Для более подробной информации обратитесь к разделу Фактор выравнивания столбцов. |
Верхнее X значение | число | Верхняя граница столбца вдоль оси определений (Х) или часть ширины столбца. Для более подробной информации обратитесь к разделу Фактор выравнивания столбцов. |
Нижнее Y значение | число | Начало столбца на оси измерений (Y). Не используется, если отключено свойство Использовать интервал Y. |
Верхнее Y значение | число | Окончание столбца на оси измерений (Y). |
Дополнительные свойства массива данных:
Автосортировка
Флажок, контролирующий автоматическое упорядочивание элементов в серии данных в восходящем порядке по х-значению.
Имя свойства: autoSort
Тип свойства: логическое
Общие свойства
Ширина, Высота, Привязки, Видимый, Непрозрачный, Фон, Рамка
Все свойства, относящиеся к данным.
Все свойства координатной области построения.
Все свойства координатного рендера.
Тени столбцов
Видимость тени
Флажок, контролирующий, будут ли отображаться тени столбцов.
Имя свойства: shadowsVisible
Тип свойства:логическое
Окраска тени
Цвет заливки тени столбца.
Имя свойства: shadowPaint
Тип свойства: таблица данных
Смещение тени по Х
X-смещение тени столбца.
Имя свойства: shadowXOffset
Тип свойства: плавающее
Смещение тени по Y
Y-смещение тени столбца.
Имя свойства: shadowYOffset
Тип свойства: плавающее
Метки элементов
Так как столбцы имеют прямоугольную форму, отрисовщик рассчитывает точки привязки, располагаемые, как указано далее на рисунке. Имейте в виду, что числа занимают (приблизительно) позицию часов на циферблате.
Если метка элемента располагается внутри столбца, рендер рассчитывает, будет ли достаточным размер столбца для вмещения текста. Если нет, рендер проверяет, определена ли для метки "альтернативная" позиция. Если таковая назначена, метка располагается согласно указанной позиции, в противном случае, метка не отображается. Могут быть определены две "альтернативные" позиции, одна для положительных значений, другая для отрицательных (примером для данного случая может послужить ситуация, когда метки положительных значений не помещаются внутри столбца и отображаются сверху столбца, а метки неподходящих по размеру отрицательных значений - снизу).
Альтернативное положение меток элементов
Данное свойство включает в себя два значения:
- Положительная позиция метки элемента: альтернативная позиция для положительных меток элементов. Установите пустое значение, если вы не хотите, чтобы метки не отображались, если они не помещаются внутри столбца.
- Отрицательная позиция метки элемента: альтернативная позиция для отрицательных меток элементов. Установите пустое значение, если вы не хотите, чтобы метки не отображались, если они не помещаются внутри столбца.
Имя свойства: itemLabelPositionFallback
Тип свойства: таблица данных
Другие свойства
Граница
Граница рендера. Граница определяется в виде процентного отношения к ширине столбца (например, 0.10 - 10 процентов) и является величиной, которая убавляется от ширины столбца перед отображением столбца на графике.
Имя свойства: margin
Тип свойства: плавающее
Окантовка столбцов
Флажок, контролирующий отображение контура вокруг каждого столбца. Цвет и тип штриха контура определяется при помощи свойств основного рендера столбцов.
Имя свойства: drawBarOutline
Тип свойства: логическое
Основание
Основное значение для столбцов.
По умолчанию рендер отображает столбец между нулевым (основное значение) и значением данных отображаемого элемента. Некоторые определенные рендеры солбцов требуют ненулевое основное значение.
Имя свойства: base
Тип свойства: плавающее
Использовать y-интервал
Флажок, контролирующий определение длины столбца. Если значение является истинным, используется y-интервал из массива данных. Если является ложным, у-значение из массива данных определяет один конец столбца, а свойство "Основа" -- другой.
Имя свойства: useYInterval
Тип свойства: логический
Коэффициент выравнивания столбцов
Коэффициент выравнивания столбца. Если коэффициент выравнивания столбца находится в пределах от 0.0 до 1.0, ширина столбца определяется х-интервалом из массива данных, в то время как позиция столбца настраивается так, что х-значение из массива данных приходится на заданную относительную позицию внутри столбца (например, 0.0 располагает столбец так, что х-значение находится слева от столбца, 0.5 -- х-значение находится по центру, 1.0 - х-значение расположено справа). Если коэффициент выравнивания столбца находится вне предела от 0.0 до 1.0, отрисовщик не будет осуществлять выравнивание (в данном случае позиция столбца определяется только х-интервалом в массиве данных, а х-значение игнорируется).
Имя свойства: barAlignmentFactor
Тип свойства: плавающее
Редактор столбцов
Редактор столбцов отвечает за актуальное отображение отдельных столбцов и имеет следующие свойства:
Свойство | Имя | Тип | Описание |
Тип | type | целое | Тип редактора: Стандартный или Градиентный:
|
G1 | g1 | плавающее | Точка деления между первой и второй градиентными областями (больше 0.0). |
G2 | g2 | плавающее | Точка деления между второй и третьей градиентными областями (больше, чем G1). |
G3 | g3 | плавающее | Точка деления между третьей и четвертой градиентными областями (больше, чем G2 и меньше 1.0). |
Имя свойства: barPainter
Тип свойства: таблица данных
Столбец легенды
Фигура, используемая для представления столбца в каждом элементе легенды.
Имя свойства: legendBar
Тип свойства: таблица данных
Другие свойства
Отображать в виде процентов
Флажок, контролирующий отображение значений в виде процентного отношения к целому по всем сериям данных.
Пример графика, который отображает значения в процентах:
Данное свойство пригодно для составного отрисовщика.
Имя свойства: renderAsPercentages
Тип свойства: логическое
Центрировать столбец по начальному значению
Флажок, контролирующий смещение группы столбцов таким образом, что её центр приходится на начальное х-значение, полученное из массива данных.
Имя свойства: centerBarAtStartValue
Тип свойства: логическое
Общие события
Скрытие, Показ, Перемещение, Изменение размеров, Клик мыши, Нажатие кнопки мыши, Отпускание кнопки мыши, Вход мыши, Выход мыши, Перемещение мыши, Вращение колесика мыши, Печать клавиши, Нажатие клавиши, Отпускание клавиши, Получение фокуса, Потеря фокуса
Все соответствующие события графика.
Дополнительные примеры
XY-Столбчатая диаграмма, созданная при помощи оси измерений типа "Ось дат". Диаграмма использует субтитры для указания источника данных:
XY-Столбчатая диаграмма, основанная на оси определений дат:
График, отображающий меняющиеся ширины столбцов. Коэффициент выравнивания столбцов является отрицательным, а Х координаты левой и правой сторон столбца основаны на значениях Х нижней и Х верхней из массива данных:
График с "плавающими" столбцами. Коэффициент выравнивания столбцов является отрицательным, а Х координаты левой и правой сторон столбца основаны на значениях Х нижней и Х верхней из массива данных. Использовать интервал Y включено, поэтому столбцы отображаются из значений массива данных Y нижней и Y верхней:
Столбчатая диаграмма, которая отображает различные интервалы вдоль оси дат Х:
Простая столбчатая диаграмма с двумя сериями данных, построенная при помощи координатного столбчатого графика:
