Bars3D QML Type

3D棒グラフ。詳細...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• barSeriesMargin : size (since 6.3)
• barSpacing : size
• barSpacingRelative : bool
• barThickness : real
• columnAxis : CategoryAxis3D
• floorLevel : real
• multiSeriesUniform : bool
• primarySeries : Bar3DSeries
• rowAxis : CategoryAxis3D
• selectedSeries : Bar3DSeries
• seriesList : list<Bar3DSeries>
• valueAxis : ValueAxis3D

方法

• void addSeries(Bar3DSeries series)
• void insertSeries(int index, Bar3DSeries series)
• void removeSeries(Bar3DSeries series)

詳細説明

この型は、Qt Quick を用いて棒グラフを 3D で描画することを可能にします。

この型を使用するには、データ可視化モジュールをインポートする必要があります：

import QtDataVisualization 1.2

その後、qmlファイルでBars3Dを使用することができます：

import QtQuick 2.0
import QtDataVisualization 1.2

Item {
    width: 640
    height: 480

    Bars3D {
        width: parent.width
        height: parent.height

        Bar3DSeries {
            itemLabelFormat: "@colLabel, @rowLabel: @valueLabel"

            ItemModelBarDataProxy {
                itemModel: dataModel
                // Mapping model roles to bar series rows, columns, and values.
                rowRole: "year"
                columnRole: "city"
                valueRole: "expenses"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ year: "2012"; city: "Oulu";     expenses: "4200"; }
        ListElement{ year: "2012"; city: "Rauma";    expenses: "2100"; }
        ListElement{ year: "2012"; city: "Helsinki"; expenses: "7040"; }
        ListElement{ year: "2012"; city: "Tampere";  expenses: "4330"; }
        ListElement{ year: "2013"; city: "Oulu";     expenses: "3960"; }
        ListElement{ year: "2013"; city: "Rauma";    expenses: "1990"; }
        ListElement{ year: "2013"; city: "Helsinki"; expenses: "7230"; }
        ListElement{ year: "2013"; city: "Tampere";  expenses: "4650"; }
    }
}

より詳細な使用例については、シンプルな棒グラフを参照してください。

Bar3DSeries,ItemModelBarDataProxy,Scatter3D,Surface3D, も参照してください。 Qt Data Visualization C++ Classes.

プロパティのドキュメント

barSeriesMargin : size [since 6.3]

XおよびZ寸法における系列列間のマージン。デフォルトでは(0.0, 0.0) 。適切な値は [0,1] の範囲です。

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

barSpacing : size

XおよびZ寸法でのバー間隔。

デフォルトでは(1.0, 1.0) に設定されています。間隔はbarSpacingRelative プロパティの影響を受けます。

barSpacingRelative : bool

間隔が絶対的か、バーの太さに対する相対的か。

true の場合、0.0 の値は、バーが左右に配置されることを意味し、1.0 は、1本のバーの太さと同じ幅のスペースがバーとバーの間に残されることを意味します。プリセットはtrue 。

barThickness : real

X寸法とZ寸法の棒の太さの比率。値1.0 は、バーの幅が奥行きと同じであることを意味し、0.5 は、バーの奥行きが幅の2倍であることを意味する。

columnAxis : CategoryAxis3D

アクティブな列軸。

軸が与えられない場合、ラベルのない一時的なデフォルト軸が作成されます。この一時的な軸は、他の軸が明示的に同じ方向に設定されると破棄されます。

floorLevel : real

Y軸データ座標における棒グラフのフロアレベル。

実際のフロア・レベルは、Y 軸の最小値と最大値によって制限されます。デフォルトはゼロ。

multiSeriesUniform : bool

複数の系列が表示されている場合でも、単一の系列バーに対して比率を設定してバーをスケーリングするかどうかを定義する。true に設定すると、bar spacing は X 軸にのみ正しく適用されます。デフォルトではfalse に設定されている。

primarySeries : Bar3DSeries

グラフの主系列。軸にラベルが明示的に設定されていない場合に、行軸と列軸のラベルを決定するために使用される。

指定された系列がまだグラフに追加されていない場合、それを主系列として設定すると、暗黙的にグラフにも追加される。

主系列自体がグラフから削除されると、このプロパティはデフォルトにリセットされる。

系列がNULLの場合、このプロパティはデフォルトにリセットされる。デフォルトは、最初に追加された系列、またはグラフに系列が追加されていない場合は0である。

rowAxis : CategoryAxis3D

アクティブな行軸。

軸が与えられない場合、ラベルのない一時的な既定の軸が作成されます。この一時的な軸は、他の軸が明示的に同じ方向に設定されると破棄されます。

selectedSeries : Bar3DSeries

選択された系列またはnull 。selectionMode にSelectionMultiSeries フラグが設定されている場合、このプロパティは選択されたバーを所有する系列を保持する。

seriesList : list<Bar3DSeries> [default]

グラフの系列。デフォルトでは、このプロパティには空のリストが含まれます。系列を設定するには、addSeries() 関数を使用するか、グラフの子として定義します。

valueAxis : ValueAxis3D

アクティブな値軸。

軸が与えられない場合、ラベルと自動調整範囲を持たない一時的なデフォルト軸が作成されます。この一時的な軸は、別の軸が明示的に同じ方向に設定されると破棄されます。

メソッドのドキュメント

void addSeries(Bar3DSeries series)

グラフにseries を追加する。グラフは複数の系列を含むことができるが、軸は1セットのみであるため、可視化されたデータが意味を持つためには、すべての系列の行と列が一致していなければならない。グラフに複数の可視系列がある場合、軸にラベルが明示的に設定されていない場合は、最初に追加された系列だけが軸の行ラベルまたは列ラベルを生成する。新しく追加された系列が選択されたバーを指定している場合は、そのバーが強調表示され、既存の選択はクリアされます。アクティブな選択を持つことができるのは、追加された 1 つの系列だけです。

AbstractGraph3D::hasSeries()も参照 。

void insertSeries(int index, Bar3DSeries series)

series をシリーズリストのindex の位置に挿入する。series がすでにリストに追加されている場合は、新しいindex に移動する。

AbstractGraph3D::hasSeries()も参照のこと 。

void removeSeries(Bar3DSeries series)

グラフからseries を削除する。

AbstractGraph3D::hasSeries()も参照のこと 。