Класс QChart

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

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

Открытые типы

Свойства

• 14 свойств унаследовано от QGraphicsWidget
• 12 свойств унаследовано от QGraphicsObject
• 1 свойство унаследовано от QObject

Открытые функции

• 53 общедоступных функций, унаследованных от QGraphicsWidget
• 2 общедоступных функции, унаследованные от QGraphicsObject
• 35 общедоступных функций, унаследованных от QGraphicsLayoutItem
• 32 общедоступных функций, унаследованных от QObject
• 176 общедоступных функций, унаследованных от QGraphicsItem

Сигналы

• 1 сигнал, унаследованный от QGraphicsWidget
• 9 сигналов, унаследованных от QGraphicsObject
• 2 сигнала, унаследованные от QObject

Дополнительные унаследованные члены

• 1 общедоступный слот, унаследованный от QGraphicsWidget
• 1 общедоступный слот, унаследованный от QObject
• 1 статический общедоступный член, унаследованный от QGraphicsWidget
• 11 статических общедоступных членов, унаследованных от QObject
• 2 статических общедоступных члена, унаследованных от QGraphicsItem
• 24 защищённых функций, унаследованных от QGraphicsWidget
• 1 защищённая функция, унаследованная от QGraphicsObject
• 3 защищённых функций, унаследованных от QGraphicsLayoutItem
• 9 защищённых функций, унаследованных от QObject
• 24 защищённых функций, унаследованных от QGraphicsItem
• 1 защищённый слот, унаследованный от QGraphicsObject

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 = Q_NULLPTR) const

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

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

QAbstractAxis *QChart::axisX(QAbstractSeries *series = Q_NULLPTR) const

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

См. также setAxisX(), addAxis(), и QAbstractSeries::attachAxis().

QAbstractAxis *QChart::axisY(QAbstractSeries *series = Q_NULLPTR) const

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

См. также setAxisY(), addAxis(), и QAbstractSeries::attachAxis().

QBrush QChart::backgroundBrush() const

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

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

QPen QChart::backgroundPen() const

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

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

void QChart::createDefaultAxes()

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

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

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

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

См. также axisX(), axisY(), axes(), setAxisX(), setAxisY(), и QAbstractSeries::attachAxis().

bool QChart::isZoomed()

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

QLegend *QChart::legend() const

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

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

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

QPointF QChart::mapToValue(const QPointF &position, QAbstractSeries *series = Q_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::setAxisX(QAbstractAxis *axis, QAbstractSeries *series = Q_NULLPTR)

Добавляет ось axis к диаграмме и прикрепляет её к ряду series как горизонтальную ось с нижним выравниванием. Диаграмма принимает во владение как ось, так и ряд. Любые горизонтальные оси, ранее прикреплённые к ряду, будут удалены.

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

void QChart::setAxisY(QAbstractAxis *axis, QAbstractSeries *series = Q_NULLPTR)

Добавляет ось axis к диаграмме и прикрепляет её к ряду series как вертикальную ось, выровненную по левому краю. Диаграмма берет на себя владение и осью, и рядом. Любые вертикальные оси, ранее прикреплённые к ряду, будут удалены.

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

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 по-прежнему полностью виден.

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

void QChart::zoomOut()

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

void QChart::zoomReset()

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

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