Тип QML ChartView

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

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

Свойства

• animationDuration : int
• animationEasingCurve : easing
• animationOptions : перечисление
• axes : список<AbstractAxis>
• backgroundColor : цвет
• backgroundRoundness : вещественное
• count : int
• dropShadowEnabled : bool
• legend : Легенда
• locale : locale
• localizeNumbers : bool
• margins : Поля
• plotArea : прямоугольник
• plotAreaColor : цвет
• theme : перечисление
• title : строка
• titleColor : цвет
• titleFont : шрифт

Сигналы

• seriesAdded(AbstractSeries series)
• seriesRemoved(AbstractSeries series)

Методы

• Axis axisX(AbstractSeries series)
• Axis axisY(AbstractSeries series)
• AbstractSeries createSeries(перечисление type, строка name, AbstractAxis axisX, AbstractAxis axisY)
• isZoomed()
• point mapToPosition(point value, AbstractSeries series)
• point mapToValue(point position, AbstractSeries series)
• removeAllSeries()
• removeSeries(AbstractSeries series)
• scrollDown(вещественное pixels)
• scrollLeft(вещественное pixels)
• scrollRight(вещественное pixels)
• scrollUp(вещественное pixels)
• AbstractSeries series(строка name)
• AbstractSeries series(int index)
• setAxisX(AbstractAxis axis, AbstractSeries series)
• setAxisY(AbstractAxis axis, AbstractSeries series)
• zoom(вещественное factor)
• zoomIn(прямоугольник rectangle)
• zoomIn()
• zoomOut()
• zoomReset()

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

Тип ChartView отображает различные типы рядов данных в виде диаграмм.

Следующий код QML демонстрирует, как создать простую диаграмму с одним круговым рядом данных:

import QtQuick 2.0
import QtCharts 2.0

ChartView {
    width: 400
    height: 300
    theme: ChartView.ChartThemeBrownSand
    antialiasing: true

    PieSeries {
        id: pieSeries
        PieSlice { label: "eaten"; value: 94.9 }
        PieSlice { label: "not yet eaten"; value: 5.1 }
    }
}

Документация по свойствам

animationDuration : int

Длительность анимации диаграммы.

animationEasingCurve : easing

Кривая плавности анимации диаграммы.

animationOptions : перечисление

Анимации, включённые в диаграмме:

axes : список<AbstractAxis>

Оси диаграммы.

backgroundColor : цвет

Цвет фона диаграммы. По умолчанию цвет фона определяется темой диаграммы.

См. также theme.

backgroundRoundness : вещественное

Диаметр окружности скругления углов фона диаграммы.

count : int

Количество добавленных рядов данных на диаграмму.

dropShadowEnabled : bool

Включить эффект тени фона.

Если установлено значение true, эффект тени фона включен. Если установлено значение false, он отключен.

legend : Легенда

Легенда диаграммы. Легенда перечисляет все ряды данных, сегменты круговой диаграммы и группы столбцов, добавленные на диаграмму.

[since QtCharts 2.0] locale : locale

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

Метки локализуются только при значении свойства localizeNumbers, равном true, за исключением меток DateTimeAxis, которые всегда используют QLocale, установленный этим свойством.

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

Это свойство было добавлено в QtCharts 2.0.

См. также localizeNumbers.

[since QtCharts 2.0] localizeNumbers : bool

Локализация чисел.

Если значение true, все генерируемые числа, отображаемые на метках различных рядов и осей, будут локализованы с помощью QLocale, установленного с помощью свойства locale. Если false, используется языковой стандарт C. По умолчанию false.

Примечание: Это свойство не влияет на метки DateTimeAxis, которые всегда используют QLocale, установленный с помощью свойства locale.

Это свойство было добавлено в QtCharts 2.0.

См. также locale.

margins : Поля

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

plotArea : прямоугольник

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

Область графика не включает область, определённую полями. По умолчанию, она перестраивается, если находится внутри ChartView. Если для области графика задан явный прямоугольник, он будет учтён. Чтобы вернуться к поведению по умолчанию, нужно установить значение в Qt.rect(0, 0, 0, 0).

См. также margins.

plotAreaColor : цвет

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

См. также backgroundColor и theme.

theme : перечисление

Тема, используемая для графика.

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

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

Поддерживаются следующие значения:

title : строка

Заголовок, отображаемый в виде заголовка над графиком. Заголовки графиков поддерживают форматирование HTML.

См. также titleColor.

titleColor : цвет

Цвет текста заголовка.

titleFont : шрифт

Шрифт заголовка графика.

Для получения дополнительной информации см. шрифт.

Документация по сигналам

seriesAdded(AbstractSeries series)

Этот сигнал отправляется, когда ряд series добавляется к графику.

Примечание: Соответствующий обработчик — onSeriesAdded.

seriesRemoved(AbstractSeries series)

Этот сигнал отправляется, когда ряд series удаляется из графика. Объект ряда становится недоступным после завершения обработки сигнала.

Примечание: Соответствующий обработчик — onSeriesRemoved.

Документация по методам

Ось axisX(AbstractSeries series)

Ось X ряда series.

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

Ось axisY(AbstractSeries series)

Ось Y ряда series.

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

AbstractSeries createSeries(перечисление type, строка name, AbstractAxis axisX, AbstractAxis axisY)

Добавляет ряд типа type в график с именем name и, по желанию, осями axisX и axisY. Например:

// lineSeries is a LineSeries object that has already been added to the ChartView; re-use its axes
var myAxisX = chartView.axisX(lineSeries);
var myAxisY = chartView.axisY(lineSeries);
var scatter = chartView.createSeries(ChartView.SeriesTypeScatter, "scatter series", myAxisX, myAxisY);

Следующие значения перечисления могут быть использованы в качестве значений type:

isZoomed()

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

точка mapToPosition(точка value, AbstractSeries series)

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

точка mapToValue(точка position, AbstractSeries series)

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

removeAllSeries()

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

removeSeries(AbstractSeries series)

Удаляет ряд series с графика и постоянно удаляет объект ряда.

scrollDown(вещественное pixels)

Прокручивает вниз на количество пикселей, указанное параметром pixels. Этот метод удобен для навигации с помощью клавиш, например.

scrollLeft(вещественное pixels)

Прокручивает влево на количество пикселей, указанное параметром pixels. Этот метод удобен для навигации с помощью клавиш, например.

scrollRight(вещественное pixels)

Прокручивает вправо на количество пикселей, указанное параметром pixels. Этот метод удобен для навигации с помощью клавиш, например.

scrollUp(вещественное pixels)

Прокручивает вверх на количество пикселей, указанное параметром pixels. Этот метод удобен для навигации с помощью клавиш, например.

AbstractSeries series(строка name)

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

AbstractSeries series(целое index)

Возвращает ряд с индексом index на графике. Вместе с свойством count графика это позволяет проходить по рядам графика.

См. также count.

setAxisX(AbstractAxis axis, AbstractSeries series)

Устанавливает ось X ряда series в axis.

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

setAxisY(AbstractAxis axis, AbstractSeries series)

Устанавливает ось Y ряда series в axis.

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

zoom(вещественное factor)

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

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

zoomIn(прямоугольник rectangle)

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

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

zoomIn()

Увеличивает масштаб графика в два раза.

zoomOut()

Уменьшает масштаб графика в два раза.

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

zoomReset()

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

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