Класс QChart

Класс QChart управляет графическим представлением рядов, легенд и осей графика. Подробнее...

• Список всех членов, включая наследуемые
• Устаревшие члены

Типы

Свойства

Общедоступные функции

Сигналы

Подробное описание

QChart — это QGraphicsWidget, который можно отобразить в QGraphicsScene. Он управляет графическим представлением различных типов рядов и других объектов, связанных с диаграммой, таких как легенда и оси. Для простого отображения диаграммы в макете можно использовать удобный класс QChartView вместо QChart. Кроме того, ряды линий, сплайнов, областей и точек рассеяния могут быть представлены как полярные диаграммы с помощью класса QPolarChart.

См. также QChartView и QPolarChart.

Документация по типам членов

перечисление QChart::AnimationOptionфлаги QChart::AnimationOptions

Это перечисление описывает анимации, включённые в диаграмму.

Тип AnimationOptions — это псевдоним для QFlags<AnimationOption>. Он хранит логическое ИЛИ комбинацию значений AnimationOption.

перечисление QChart::ChartTheme

Это перечисление описывает тему, используемую диаграммой.

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

Примечание: Изменение темы перезапишет все ранее применённые настройки к рядам.

перечисление QChart::ChartType

Это перечисление описывает тип диаграммы.

Документация функций-членов

QChart::QChart(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())

Создаёт объект графика, являющийся дочерним элементом parent. Свойства, указанные в wFlags, передаются конструктору QGraphicsWidget.

[virtual] QChart::~QChart()

Удаляет объект графика и его дочерние элементы, такие как серии и оси, добавленные к нему.

void QChart::addAxis(QAbstractAxis *axis, Qt::Alignment alignment)

Добавляет ось axis на график, выравнивая её в соответствии с alignment. График принимает во владение ось.

См. также removeAxis(), createDefaultAxes() и QAbstractSeries::attachAxis().

void QChart::addSeries(QAbstractSeries *series)

Добавляет серию series на график и принимает её во владение.

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

См. также removeSeries(), removeAllSeries(), createDefaultAxes() и QAbstractSeries::attachAxis().

QList<QAbstractAxis *> QChart::axes(Qt::Orientations orientation = Qt::Horizontal|Qt::Vertical, QAbstractSeries *series = nullptr) const

Возвращает оси, прикреплённые к серии series с ориентацией, заданной orientation. Если серия не указана, возвращаются все оси, добавленные на график с указанной ориентацией.

См. также addAxis() и createDefaultAxes().

QBrush QChart::backgroundBrush() const

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

См. также setBackgroundBrush().

QPen QChart::backgroundPen() const

Получает перо, используемое для отрисовки фона области графика.

См. также setBackgroundPen().

void QChart::createDefaultAxes()

Создаёт оси для графика на основе серий, которые уже были добавлены на график. Любые ранее добавленные оси на графике будут удалены.

Примечание: Эта функция должна вызываться после того, как все серии будут добавлены на график. Оси, созданные этой функцией, НЕ будут автоматически прикреплены к любой серии, добавленной на график после вызова этой функции. Серия без прикреплённых осей по умолчанию будет масштабироваться, чтобы использовать всю область графика, что может быть запутанно, если на графике также присутствуют другие серии с должным образом прикреплёнными осями.

Если на графике добавлены несколько серий, производных от QXYSeries, и не добавлено серий других типов, то создаётся только одна пара осей. Если на график добавлены несколько серий разных типов, то каждой серии создаётся своя пара осей.

Оси, специфичные для серии, можно позже получить с помощью графика, передав серию как параметр вызова функции axes(). QPieSeries не создаёт никаких осей.

См. также axes() и QAbstractSeries::attachAxis().

bool QChart::isZoomed()

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

QLegend *QChart::legend() const

Возвращает объект легенды графика. Владение остаётся у графика.

QPointF QChart::mapToPosition(const QPointF &value, QAbstractSeries *series = nullptr)

Возвращает позицию на графике, соответствующую значению value в серии, указанной series.

QPointF QChart::mapToValue(const QPointF &position, QAbstractSeries *series = nullptr)

Возвращает значение в серии, указанной series, в позиции, указанной position на графике.

QBrush QChart::plotAreaBackgroundBrush() const

Возвращает кисть, используемую для заполнения фона области графика.

См. также plotArea(), plotAreaBackgroundVisible, plotAreaBackgroundPen() и setPlotAreaBackgroundBrush().

QPen QChart::plotAreaBackgroundPen() const

Возвращает перо, используемое для отрисовки фона области графика.

См. также plotArea(), plotAreaBackgroundVisible, plotAreaBackgroundBrush() и setPlotAreaBackgroundPen().

void QChart::removeAllSeries()

Удаляет и уничтожает все объекты серий, которые были добавлены на график.

См. также addSeries() и removeSeries().

void QChart::removeAxis(QAbstractAxis *axis)

Удаляет ось axis с графика. График освобождает владение указанным объектом оси axis.

См. также addAxis(), createDefaultAxes() и QAbstractSeries::detachAxis().

void QChart::removeSeries(QAbstractSeries *series)

Удаляет серию series с графика. График освобождает владение указанным объектом серии series.

См. также addSeries() и removeAllSeries().

void QChart::scroll(qreal dx, qreal dy)

Прокручивает видимую область графика на расстояние, заданное dx и dy.

Для полярных графиков dx указывает угол вдоль угловой оси, а не расстояние.

QList<QAbstractSeries *> QChart::series() const

Возвращает все серии, добавленные на график.

См. также addSeries(), removeSeries() и removeAllSeries().

void QChart::setBackgroundBrush(const QBrush &brush)

Устанавливает кисть для фона области графика в brush.

См. также backgroundBrush().

void QChart::setBackgroundPen(const QPen &pen)

Устанавливает перо для фона области графика в pen.

См. также backgroundPen().

void QChart::setPlotAreaBackgroundBrush(const QBrush &brush)

Устанавливает кисть для заполнения фона области графика в brush.

См. также plotArea(), plotAreaBackgroundVisible, setPlotAreaBackgroundPen() и plotAreaBackgroundBrush().

void QChart::setPlotAreaBackgroundPen(const QPen &pen)

Устанавливает перо, используемое для рисования фона области графика, в pen.

См. также plotArea(), plotAreaBackgroundVisible, setPlotAreaBackgroundBrush(), и plotAreaBackgroundPen().

void QChart::setTitleBrush(const QBrush &brush)

Устанавливает кисть, используемую для рисования текста заголовка, в brush.

См. также titleBrush().

void QChart::setTitleFont(const QFont &font)

Устанавливает шрифт, используемый для рисования заголовка графика, в font.

См. также titleFont().

QBrush QChart::titleBrush() const

Возвращает кисть, используемую для рисования текста заголовка.

См. также setTitleBrush().

QFont QChart::titleFont() const

Возвращает шрифт, используемый для рисования заголовка графика.

См. также setTitleFont().

void QChart::zoom(qreal factor)

Увеличивает масштаб просмотра на заданный множитель factor.

Множитель больше 1.0 увеличивает масштаб, а множитель между 0.0 и 1.0 уменьшает его.

void QChart::zoomIn()

Увеличивает масштаб просмотра в два раза.

void QChart::zoomIn(const QRectF &rect)

Увеличивает масштаб просмотра до максимального уровня, при котором прямоугольник rect по-прежнему полностью виден.

Примечание: Применение масштабирования может изменить свойства присоединённых осей, например, QAbstractAxis::min и QAbstractAxis::max.

Примечание: Для полярных графиков это не поддерживается.

void QChart::zoomOut()

Уменьшает масштаб просмотра в два раза.

Примечание: Это не будет выполняться, если результат будет содержать недопустимый диапазон логарифмической оси.

void QChart::zoomReset()

Сбрасывает области данных серий до значений, установленных до вызова любого метода масштабирования.

Примечание: Это также сбросит прокрутку и явные настройки диапазонов осей, заданные между первым масштабированием и вызовом этого метода. Если операции масштабирования не выполнялись, этот метод ничего не делает.