ChartView QML Type

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

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

プロパティ

• 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)
• bool isZoomed()
• point mapToPosition(point value, AbstractSeries series)
• point mapToValue(point position, AbstractSeries series)
• void removeAllSeries()
• void removeSeries(AbstractSeries series)
• void scrollDown(real pixels)
• void scrollLeft(real pixels)
• void scrollRight(real pixels)
• void scrollUp(real pixels)
• AbstractSeries series(int index)
• AbstractSeries series(string name)
• void setAxisX(AbstractAxis axis, AbstractSeries series)
• void setAxisY(AbstractAxis axis, AbstractSeries series)
• void zoom(real factor)
• void zoomIn()
• void zoomIn(rect rectangle)
• void zoomOut()
• void 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

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

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 です。

このプロパティは 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 の例では、テーマの設定方法を説明しています。

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

title : string

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

titleColorも参照 。

titleColor : color

タイトル文字の色。

titleFont : font

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

詳細はfont を参照。

シグナル・ドキュメント

seriesAdded(AbstractSeries series)

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

seriesRemoved(AbstractSeries series)

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

メソッドのドキュメント

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

bool isZoomed()

ズーム領域を持つ系列があればtrue を返す。

point mapToPosition(point value, AbstractSeries series)

series シリーズの値value のチャートにおける位置を返す。

point mapToValue(point position, AbstractSeries series)

チャートのposition の位置にあるseries シリーズの値を返します。

void removeAllSeries()

チャートからすべての系列を削除し、すべての系列オブジェクトを永久に削除する。

void removeSeries(AbstractSeries series)

チャートから系列series を削除し、系列オブジェクトを永久に削除します。

void scrollDown(real pixels)

pixels で指定したピクセル数だけ下にスクロールする。これはキーナビゲーションなどに適した便利な方法である。

void scrollLeft(real pixels)

pixels で指定したピクセル数だけ左にスクロールする。これはキーナビゲーションなどに適した便利な方法である。

void scrollRight(real pixels)

pixels で指定したピクセル数だけ右にスクロールする。これはキーナビゲーションなどに適した便利な方法である。

void scrollUp(real pixels)

pixels で指定したピクセル数だけスクロールアップする。これはキーナビゲーションなどに適した便利な方法である。

AbstractSeries series(int index)

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

countも参照 。

AbstractSeries series(string name)

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

void setAxisX(AbstractAxis axis, AbstractSeries series)

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

axisX()も参照 。

void setAxisY(AbstractAxis axis, AbstractSeries series)

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

axisY()も参照 。

void zoom(real factor)

factor 。

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

void zoomIn()

ビューを2倍に拡大する。

void zoomIn(rect rectangle)

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

void zoomOut()

ビューを2倍にズームアウトする。

void zoomReset()

シリーズのドメインを、ズーム・メソッドが呼び出される前の状態にリセットします。