Тип 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)

Методы

• Ось axisX(AbstractSeries series)
• Ось 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 : Легенда

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

[с QtCharts 2.0] locale : locale

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

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

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

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

См. также localizeNumbers.

[с QtCharts 2.0] localizeNumbers : bool

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

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

Это свойство было введено в 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()

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