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"; }
    }
}

より詳細な使用例については、「Simple Bar Graph」を参照してください。

関連項目： 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軸の最小値と最大値によって制限されます。デフォルトは0です。

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組のみであるため、可視化されたデータに意味を持たせるには、すべての系列の行と列が一致している必要があります。 グラフに複数の可視化シリーズが存在する場合、軸のラベルが明示的に設定されていないときは、最初に追加されたシリーズのみが軸上の行ラベルまたは列ラベルを生成します。新しく追加されたシリーズで選択バーが指定されている場合、そのバーが強調表示され、既存の選択は解除されます。アクティブな選択状態にあるシリーズは、追加されたシリーズのうち1つだけとなります。

AbstractGraph3D::hasSeries()も参照してください 。

void insertSeries(int index, Bar3DSeries series)

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

関連項目： AbstractGraph3D::hasSeries()。

void removeSeries(Bar3DSeries series)

グラフからseries を取り除きます。

「AbstractGraph3D::hasSeries()」も参照してください 。