Charts Widget  1.03
Charts Widget Документация

chartsWidget - виджет отображения графиков для Qt5. Отображает произвольное количество графиков на единой шкале.

История версий

Версия виджета 1.03

1.03 - Добавлено сохранение содержимого виджета в графический файл. Исправлен вылет программы, при наведении мыши на виджет с пустыми данными.

1.02 - Добавлена заливка площади под графиками.

1.01 - Первая публикация.

Установка

Заголовочный файл: chartsWidget.h

qmake: QT += printsupport

  • Пропишите в pro файле своего проекта QT += printsupport для использования возможностей сохранения и печати графиков;
  • Скопируйте папку chartsWidget в свой проект;
  • Добавьте файлы из папки в проект;
  • Разместите на форме экземпляр QWidget;
  • Назовите размещенный виджет как-то типа myChartsWidget;
  • Откройте контекстное меню, щёлкнув правой кнопкой мыши на созданном виджете, и выберите пункт Преобразовать в..;
  • В появившейся форме укажите Имя Преобразованного Класса chartsWidget и Заголовочный файл chartsWidget/chartsWidget.h;
  • Нажмите кнопку Добавить и затем кнопку Преобразовать;
  • Пересоберите проект;
  • Виджет можно использовать, он будет доступен как и другие виджеты через указатель ui->имя_вашего_виджета;

Настройка

По умолчанию модуль уже настроен так, что хоть что-нибудь да выведет. Достаточно только задать ему хотя-бы две точки по оси аргументов, и он уже нарисует линию на координатных осях.

См. также
Настройка модуля

Данные

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

  • Аргумент argName передается как текстовая строка, поскольку виджет может отображать самую разную информацию — не только числа, но и даты, части числа и Пи и т. п. Все имеющиеся точки графика выводятся через равные промежутки по оси аргументов. Пользователь сам должен позаботиться о равномерном, без пропусков, заполнении набора точек;
  • Тип вертикальной линии шкалы может быть выбран из списка axisLineStyle
  • Каждая точка может иметь от одного до нескольких значений value, соответствующих аргументу. Количество значений соответствует значению выводимых графиков. Если количество значений для разных точек набора данных варьируется, виджет сам достроит недостающие значения — они будут приравнены нулю. Виджет поддерживает динамическое добавление новых данных и удаление старых, что позволяет отслеживать значения на графике в реальном времени. Например при использовании функций append() и removeFirst() график будет продвигаться справа налево, и самые свежие данные будут находиться в правой части шкалы. При использовании функций prepend() и removeLast() вы получите обратную картину. При этом виджет будет каждый раз перестраивать шкалу, исходя из имеющегося в данный момент набора точек. Количество отображаемых точек пользователь контролирует сам с помощью функции count().

После любого изменения в настройках либо данных виджета, необходимо вызвать метод базового класса QWidget::repaint(), для перерисовки содержимого виджета.

См. также
Работа с данными

Вывод и сохранение данных

Содержимое виджета может быть выведено на печать или сохранено в файл в формате PDF или в одном из графических форматов. Это может быть сделано средствами самого виджета — из контекстного меню по правой кнопке мыши, или из пользовательской программы, с помощью функций printOut() и saveImage().

См. также
Вывод данных на печать и в файл

Авторские права

Автор
Матяш Александр Валентинович

alex@.nosp@m.hawk.nosp@m.it.ru

Кодировка - UTF-8

Данный файл распространяется по лицензии GNU/GPL v.3. Подробнее о лицензии GNU/GPL можно узнать по адресу http://www.gnu.org/licenses/gpl.html


HawKit 2017 г.