ChartView QML Type

チャートの系列、凡例、軸のグラフ表示を管理する。詳細...

Import Statement:	`import QtCharts 2.8`
Inherited By:	PolarChartView

継承されたメンバを含むすべてのメンバのリスト

プロパティ

animationDuration : int
animationEasingCurve : easing
animationOptions : enumeration
axes : list<AbstractAxis>
backgroundColor : color
backgroundRoundness : real
count : int
dropShadowEnabled : bool
legend : Legend
locale : locale (since QtCharts 2.0)
localizeNumbers : bool (since QtCharts 2.0)
margins : Margins
plotArea : rect
plotAreaColor : color
theme : enumeration
title : string
titleColor : color
titleFont : font

シグナル

seriesAdded(AbstractSeries series)
seriesRemoved(AbstractSeries series)

メソッド

Axis axisX(AbstractSeries series)
Axis axisY(AbstractSeries series)
AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)
isZoomed()
point mapToPosition(point value, AbstractSeries series)
point mapToValue(point position, AbstractSeries series)
removeAllSeries()
removeSeries(AbstractSeries series)
scrollDown(real pixels)
scrollLeft(real pixels)
scrollRight(real pixels)
scrollUp(real pixels)
AbstractSeries series(int index)
AbstractSeries series(string name)
setAxisX(AbstractAxis axis, AbstractSeries series)
setAxisY(AbstractAxis axis, AbstractSeries series)
zoom(real factor)
zoomIn()
zoomIn(rect rectangle)
zoomOut()
zoomReset()

詳細説明

ChartViewタイプは、チャートとして異なるシリーズタイプを表示します。

この例では、単純な折れ線グラフを作成する方法を示します：

ChartView {
    title: "Line Chart"
    anchors.fill: parent
    antialiasing: true

    LineSeries {
        name: "Line"
        XYPoint { x: 0; y: 0 }
        XYPoint { x: 1.1; y: 2.1 }
        XYPoint { x: 1.9; y: 3.3 }
        XYPoint { x: 2.1; y: 2.1 }
        XYPoint { x: 2.9; y: 4.9 }
        XYPoint { x: 3.4; y: 3.0 }
        XYPoint { x: 4.1; y: 3.3 }
    }
}

プロパティの説明

animationDuration : int

チャートのアニメーションの持続時間

animationEasingCurve : easing

チャートのアニメーションのイージングカーブ。

animationOptions : enumeration

チャートで有効なアニメーション

定数	説明
`ChartView.NoAnimation`	チャートのアニメーションを無効にします。これはデフォルト値です。
`ChartView.GridAxisAnimations`	グリッド軸のアニメーションがチャートで有効。
`ChartView.SeriesAnimations`	チャートの直列アニメーションが有効
`ChartView.AllAnimations`	すべてのアニメーションが有効です。

axes : list<AbstractAxis>

チャートの軸

backgroundColor : color

チャートの背景色。デフォルトでは、背景色はチャートのテーマによって指定されます。

themeも参照。

backgroundRoundness : real

チャートの背景の角の丸い円の直径。

count : int

チャートに追加される系列の数。

dropShadowEnabled : bool

背景ドロップシャドウ効果を有効にするかどうか。

true に設定すると、背景ドロップシャドウ効果が有効になる。false に設定すると無効になります。

legend : Legend

チャートの凡例。凡例には、チャートに追加されたすべての系列、パイ・スライス、バー・セットがリストされます。

locale : locale [since QtCharts 2.0]

ロケールさまざまなチャート・ラベルの書式に使用されるロケール。

ラベルは、localizeNumbers がtrue の場合のみローカライズされます。ただし、DateTimeAxis ラベルは、常にこのプロパティで設定されたQLocale を使用します。

デフォルトは、チャートが作成された時点でのアプリケーションのデフォルトロケールです。

このプロパティは QtCharts 2.0 で導入されました。

localizeNumbersも参照してください。

localizeNumbers : bool [since QtCharts 2.0]

数値をローカライズするかどうか。

true の場合、様々な系列や軸ラベルに表示される生成されたすべての数値は、locale プロパティで設定されたQLocale を使用してローカライズされます。false の場合、Cロケールが常に使用されます。デフォルトはfalse です。

注: このプロパティはDateTimeAxis ラベルには影響しません。ラベルは常に、locale プロパティで設定されたQLocale を使用します。

このプロパティは QtCharts 2.0 で導入されました。

localeも参照してください。

margins : Margins

チャート矩形の端とプロット領域の間に許される最小マージン。この余白は、タイトル、軸、凡例の描画に使用されます。

plotArea : rect

チャートが描画される矩形。

プロット領域はマージンで定義された領域を含まない。デフォルトでは、ChartView の内側であれば、これはリサイズされます。プロット領域に明示的な矩形が設定されている場合は、これを尊重します。デフォルトの動作に戻すには、Qt.rect(0, 0, 0, 0) に設定することで実現されます。

marginsも参照してください。

plotAreaColor : color

プロットエリアの背景色。デフォルトでは、プロットエリアの背景は、チャートのテーマによって指定されたチャートの背景色を使用します。

backgroundColor およびtheme も参照。

theme : enumeration

チャートで使われるテーマ。

テーマとは、軸、タイトル、凡例だけでなく、系列の色、ペン、ブラシ、フォントなど、チャートのすべての視覚的要素に適用されるUIスタイルに関連する設定の組み込みコレクションです。Qml Oscilloscope の例では、テーマの設定方法を説明しています。

注：テーマを変更すると、以前にシリーズに適用されたすべてのカスタマイズが上書きされます。

以下の値がサポートされています：

定数	説明
`ChartView.ChartThemeLight`	ライト・テーマ（デフォルトのテーマ）。
`ChartView.ChartThemeBlueCerulean`	セルリアンブルーのテーマ。
`ChartView.ChartThemeDark`	暗いテーマ。
`ChartView.ChartThemeBrownSand`	サンドブラウンのテーマ。
`ChartView.ChartThemeBlueNcs`	ナチュラルカラーシステム（NCS）ブルーのテーマ。
`ChartView.ChartThemeHighContrast`	ハイコントラストのテーマ。
`ChartView.ChartThemeBlueIcy`	アイシーブルーのテーマ。
`ChartView.ChartThemeQt`	Qtテーマ。

title : string

タイトルはチャートの上部に見出しとして表示されます。チャートのタイトルはHTMLフォーマットに対応しています。

titleColorも参照してください。

titleColor : color

タイトルテキストの色。

titleFont : font

チャートのタイトルのフォント。

詳細はfont を参照。

シグナル・ドキュメント

seriesAdded(AbstractSeries series)

このシグナルは、series のシリーズがチャートに追加されたときに発行されます。

注: 対応するハンドラはonSeriesAdded です。

seriesRemoved(AbstractSeries series)

このシグナルは、series の系列がチャートから削除されたときに発生します。シグナルハンドラが完了すると、シリーズオブジェクトは無効となる。

注：対応するハンドラはonSeriesRemoved 。

メソッド・ドキュメント

Axis axisX(AbstractSeries series)

series の x 軸。

setAxisX()も参照のこと 。

Axis axisY(AbstractSeries series)

series の y 軸。

setAxisY()も参照 。

AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)

name という名前と、オプションで軸axisX およびaxisY を持つ、type 型の系列をチャートに追加する。例えば

// 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 の値として使用できます：

定数	説明
`ChartView.SeriesTypeLine`	線分系列
`ChartView.SeriesTypeArea`	面積系列
`ChartView.SeriesTypeBar`	棒系列
`ChartView.SeriesTypeStackedBar`	積み重ね棒系列
`ChartView.SeriesTypePercentBar`	パーセント棒系列
`ChartView.SeriesTypeBoxPlot`	ボックスプロット系列
`ChartView.SeriesTypeCandlestick`	ローソク足系列
`ChartView.SeriesTypePie`	円グラフ
`ChartView.SeriesTypeScatter`	散布図系列
`ChartView.SeriesTypeSpline`	スプライン系列
`ChartView.SeriesTypeHorizontalBar`	水平棒系列
`ChartView.SeriesTypeHorizontalStackedBar`	水平積み重ね棒系列
`ChartView.SeriesTypeHorizontalPercentBar`	水平パーセント棒系列

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(int index)

チャート上のインデックスindex を持つ系列を返します。チャートのcount プロパティと併用することで、チャートの系列をループすることができます。

countも参照。

AbstractSeries series(string name)

name 関数は、という名前を持つ、チャートの最初の系列を返します。その名前を持つ系列がない場合は、null を返します。

setAxisX(AbstractAxis axis, AbstractSeries series)

series の x 軸をaxis に設定する。

axisX()も参照 。

setAxisY(AbstractAxis axis, AbstractSeries series)

series の y 軸をaxis に設定します。

axisY() も参照。

zoom(real factor)

チャートをカスタム係数factor でズームします。

1.0を超える倍率でズームインし、0.0から1.0の間の倍率でズームアウトする。

zoomIn()

表示倍率を2倍まで拡大します。

zoomIn(rect rectangle)

矩形rectangle がまだ完全に見える最大レベルまでビューをズームします。

注：これは極座標図ではサポートされていません。

zoomOut()

ビューから 2 倍ズームアウトします。

注意 : 結果に無効な対数軸範囲が含まれる場合、これは何もしない。

zoomReset()

ズーム・メソッドを呼び出す前の状態にリセットします。

注意： これは、最初のズーム操作からこのメソッドを呼び出すまでの間に指定されたスクロールと明示的な軸範囲の設定もリセットします。ズーム操作が実行されていない場合、このメソッドは何もしません。

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。