BarSeries QML Type
データを棒グラフで表示します。もっと見る...
| Import Statement: | import QtGraphs |
| In C++: | QBarSeries |
| Inherits: |
- 継承されたメンバを含む、すべてのメンバの一覧
- BarSeries はQt Graphs QML Types for 2D に含まれます。
プロパティ
- barDelegate : Component
- barSets : list<BarSet>
- barWidth : real
- barsType : enumeration
- borderColors : list<color>
- count : int
- labelsAngle : real
- labelsFormat : string
- labelsMargin : real
- labelsPosition : enumeration
- labelsPrecision : real
- labelsVisible : bool
- seriesColors : list<color>
シグナル
メソッド
- BarSet append(string label, VariantList values)
- BarSet at(int index)
- Barset at(int index)
- clear()
- int find(BarSet barset)
- BarSet insert(int index, string label, VariantList values)
- bool remove(BarSet barset)
- bool remove(int index)
- removeMultiple(int index, int count)
- bool replace(list<BarSet> sets)
- bool replace(BarSet oldSet, BarSet newSet)
- bool replace(int index, BarSet barset)
詳細説明
デフォルトでは、カテゴリごとにグループ化された一連の棒グラフとしてデータを描画します。また、水平バーや、積み重ねられたバーのグループ化もサポートします。
プロパティの説明
barDelegate : Component |
各バーを視覚化するために使用されるカスタム QML コンポーネント。このコンポーネントのインスタンスは、各バーごとに作成されます。このコンポーネントが定義されていない場合、デフォルトの矩形が使用されます。
このコンポーネントで利用可能な動的プロパティは以下の通りです：
| タイプ | 名前 | 説明 |
|---|---|---|
| 色 | バーの色 | バーの塗りつぶし色。この値はGraphsTheme から、またはBarSet が色を上書きする場合はBarSet::color から取得します。 |
| 色 | バー境界色 | バーのボーダーの色。この値はGraphsTheme から、またはBarSet が色を上書きする場合はBarSet::borderColor から取得します。 |
| 実数 | barBorderWidth | バーのボーダーの幅。この値はGraphsTheme またはBarSet が幅を上書きする場合はBarSet::borderWidth から取得します。 |
| 実数 | バー値 | バーの値。この値はBarSet::values から取得します。 |
| 文字列 | バーラベル | バーのラベル。この値はBarSet::label に由来する。 |
| ブール | barSelected | この値は、バーが選択されているとき、つまりバーのインデックスがBarSet::selectedBars にあるときに真になります。 |
これらのいずれかを使用するには、定義された名前のプロパティをカスタム・コンポーネントに追加します。例えば、"property color barColor" や"property real barValue" などです。
barWidth : real |
幅の単位はX軸の単位。棒グラフの最小幅はゼロで、負の値はゼロとして扱われます。幅をゼロに設定すると、x軸のスケールに関係なく、画面上のバーの幅は1ピクセルになる。ゼロより幅の広いバーは、x 軸のスケールを使用してスケーリングされます。
デフォルトでは、barWidthは0.5です（バーは利用可能な幅の50％を占めます）。有効な値の範囲は、0.0 (0%) から 1.0 (100%) です。
注： BarSeries タイプで使用する場合、この値は、単一のバーの幅ではなく、バーのグループの幅を指定する。
barsType : enumeration |
バー・シリーズのタイプ：
| 定数 | 説明 |
|---|---|
BarSeries.BarsType.Groups | バー・セットは、カテゴリごとにグループ化されます。これはデフォルト値です。 |
BarSeries.BarsType.Stacked | バー・セットは、カテゴリごとに互いに積み重ねられる。 |
BarSeries.BarsType.StackedPercent | バー・セットは、カテゴリー別に積み重ねられる。セグメント・サイズは、スタック内のすべてのセグメントの合計値と比較したセグメント値のパーセンテージに対応する。 |
シリーズ内のすべてのオブジェクトに使用されるボーダー・カラーのリスト。
シリーズが色よりも多い場合は、色のリストは折り返し、リストの最初の色から再スタートします。こ れが設定 さ れていない場合 （デフ ォル ト ）、GraphsTheme::borderColors の色が使用 さ れます。
count : int |
バー・シリーズのバー・セットの数。
labelsAngle : real |
値ラベルの角度（度単位）。
labelsFormat : string |
棒系列のラベル表示に使用されるフォーマット。
QBarSeries::labelsFormat 、labelsVisible 、およびlabelsPositionも参照 。
labelsMargin : real |
値ラベルのマージン（ピクセル）。
この余白は、labelsPosition がLabelsPosition.Center 以外に設定されている場合に使用される。 デフォルト値は0 。
labelsPosition : enumeration |
データ値ラベルの位置：
| 定数 | 説明 |
|---|---|
BarSeries.LabelsPosition.Center | ラベルはバーの中央に配置される。 |
BarSeries.LabelsPosition.InsideEnd | ラベルはバーの中央に配置される。 |
BarSeries.LabelsPosition.InsideBase | ラベルが下のバーの内側にある。 |
BarSeries.LabelsPosition.OutsideEnd | ラベルは上部のバーの外側にある。 |
labelsVisible およびlabelsFormatも参照のこと 。
labelsPrecision : real |
値ラベルに表示される最大有効桁数。
デフォルト値は 6。
labelsVisible : bool |
棒系列内のラベルの可視性。デフォルトのラベルの可視性はfalse 。
一連のオブジェクトすべてに使用する基本色のリスト。
系列が色より多い場合、色リストは折り返され、リストの最初の色から再スタートします。こ れが設定 さ れていない と き （デフ ォ ル ト ） は、GraphsTheme::seriesColors の色が使われます。
シグナルの説明
barsetsAdded() |
このシグナルは、シリーズにバーセットが追加されたときに発せられます。
注意: 対応するハンドラはonBarsetsAdded です。
barsetsRemoved() |
このシグナルは、バーセットがシリーズから削除されたときに発せられる。
注 ：対応するハンドラはonBarsetsRemoved 。
メソッドの説明
label とvalues を持つ新しいバーセットをインデックスに追加します。values は実数値のリストです。
例えば
myBarSeries.append("set 1", [0, 0.2, 0.2, 0.5, 0.4, 1.5, 0.9]);
Barset at(int index) |
index で指定されたバーセットをシリーズから返します。それ以外の場合はnull を返す。
clear() |
シリーズからすべてのバーセットを削除します。
index およびcount で指定された範囲のバー・セットを削除する。削除に失敗した場合でも、この呼び出しはすべてのセットを走査します。
現在のすべてのバー・セットをsets で完全に置き換えます。サイズは一致する必要はありません。sets のバー・セットのいずれかが無効な場合、false を返します。
oldSet で指定されたバー・セットを newSet で置き換えます。削除に成功した場合はtrue を返し、そうでない場合はfalse を返します。oldSet は、削除に成功すると破棄されます。
index で指定された位置のバーセットをシリーズから置き換え、barset で置き換えます。成功した場合はtrue を、失敗した場合はfalse を返します。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
