Тип QML ChartView

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

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

Свойства

• animationDuration : int
• animationEasingCurve : easing
• animationOptions : перечисление
• axes : список<AbstractAxis>
• backgroundColor : цвет
• backgroundRoundness : вещественное
• count : int
• dropShadowEnabled : bool
• legend : Легенда
• locale : locale
• localizeNumbers : bool
• margins : 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()
• точка mapToPosition(точка value, AbstractSeries series)
• точка mapToValue(точка 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 : Легенда

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

locale : locale

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

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

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

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

См. также localizeNumbers.

localizeNumbers : bool

Локализовать числа.

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

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

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

См. также locale.

margins : Margins

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

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

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

Область построения не включает область, определённую отступами.

См. также margins.

plotAreaColor : цвет

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

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

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

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

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

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

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

title : string

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

См. также titleColor.

titleColor : color

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

titleFont : font

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

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

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

seriesAdded(AbstractSeries series)

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

seriesRemoved(AbstractSeries series)

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

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

Axis axisX(AbstractSeries series)

Ось X серии.

Axis axisY(AbstractSeries series)

Ось Y серии.

AbstractSeries createSeries(enumeration type, string 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 если какая-либо серия имеет масштабируемый домен.

point mapToPosition(point value, AbstractSeries series)

Возвращает положение на диаграмме значения value в серии series.

point mapToValue(point position, AbstractSeries series)

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

removeAllSeries()

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

removeSeries(AbstractSeries series)

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

scrollDown(real pixels)

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

scrollLeft(real pixels)

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

scrollRight(real pixels)

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

scrollUp(real pixels)

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

AbstractSeries series(string name)

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

AbstractSeries series(int index)

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

См. также count.

setAxisX(AbstractAxis axis, AbstractSeries series)

Устанавливает ось X серии.

setAxisY(AbstractAxis axis, AbstractSeries series)

Устанавливает ось Y серии.

zoom(real factor)

Масштабирует диаграмму на заданный множитель factor.

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

zoomIn(rect rectangle)

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

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

zoomIn()

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

zoomOut()

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

zoomReset()

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

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