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 を参照してください。

Signalのドキュメント

seriesAdded(AbstractSeries series)

このシグナルは、シリーズ「series 」がチャートに追加された際に発せられます。

seriesRemoved(AbstractSeries series)

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

メソッドのドキュメント

Axis axisX(AbstractSeries series)

series のx軸。

setAxisX()も参照してください 。

Axis axisY(AbstractSeries series)

series の y 軸。

setAxisY()も参照してください 。

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 の値として、以下の列挙値を使用できます：

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分の1の倍率で縮小します。

void zoomReset()

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