Back to Qt.io
Contact Us Blog Download Qt
このページでは

Bar3DSeries QML Type

データ系列を3D棒グラフで表現します。詳細...

Import Statement: import QtGraphs
In C++: QBar3DSeries
Inherits:

Abstract3DSeries

プロパティ

信号

方法

詳細説明

この型は、シリーズ固有のビジュアルエレメントと、（データプロキシを介した）シリーズデータを管理する。

Bar3DSeriesはitemLabelFormatに以下のフォーマットタグをサポートする：

行タイトル行軸からのタイトル
colTitle列軸からのタイトル
値軸からのタイトル値軸からのタイトル
行インデックス可視行インデックス。グラフロケールでローカライズ。
colIdx可視の列インデックス。グラフロケールを使用してローカライズされます。
行ラベル行軸のラベル。
colLabel列軸のラベル
値ラベルグラフに付属する値軸の書式を使用してフォーマットされた項目値。詳細については、labelFormat を参照してください。
シリーズ名系列の名前。
<フォーマット仕様指定された形式での項目値。labelFormat と同じルールを使用してフォーマットされます。

より完全な説明については、QBar3DSeries を参照してください。

Qt Graphs 3Dによるデータ処理も参照してください 。

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

baseColor : color

シリーズのベースカラー。

colorStyle およびGraphsTheme.seriesColorsも参照の こと。

baseGradient : Gradient

シリーズのベース勾配。

colorStyleも参照のこと 。

colorStyle : GraphsTheme.ColorStyle

シリーズのカラースタイル。

GraphsTheme.ColorStyleも参照 。

columnLabels : list

配列のカラムラベル。この配列のインデックスは、行のカラムインデックスと一致する。リストが最長の行よりも短い場合は、すべての列にラベルが付与されません。

dataArray : BarDataArray

データ配列の参照を保持する。

dataArrayChanged newDataArray が前のものと同じでない限り、データ配列が設定されるとシグナルが発せられる。

注意： dataArrayに関して何かをする前に、関連するプロキシに対してシリーズを作成する必要があります。

dataProxy : BarDataProxy

アクティブなデータプロキシ。この系列は、その系列に設定されているプロキシの所有権を引き受け、新しいプロキシが追加されると、以前に設定されていたプロキシは削除される。プロキシをNULLにしたり、別の系列に設定したりすることはできない。

invalidSelectionPosition : point [read-only]

無効な選択位置を提供する定数プロパティ。この位置は、selectedBar プロパティに代入され、このシリーズからの選択をクリアする。

GraphsItem3D.clearSelection()も参照 。

itemLabel : string [read-only]

フォーマットされた項目ラベル。選択項目がないか、選択項目が表示されていない場合は、空の文字列を返します。

itemLabelFormatも参照してください 。

itemLabelFormat : string

このシリーズのデータ項目のラベルフォーマット。この書式は、項目が選択されたときなど、単一の項目ラベルに使用される。この書式がどのように解釈されるかは、シリーズ・タイプによって異なる。

Bar3DSeries 、Scatter3DSeries 、Surface3DSeriesも参照のこと 。

itemLabelVisible : bool

true の場合、アイテム・ラベルはグラフのフローティング・ラベルとして描画される。そうでない場合、項目ラベルは描画されない。外部コントロールに項目ラベルを表示するには、このプロパティをfalse に設定する。デフォルトはtrue 。

itemLabelFormat およびitemLabelも参照のこと 。

lightingMode : Abstract3DSeries.LightingMode [since 6.10]

シリーズ内のアイテムの照明モード。デフォルト値はQAbstract3DSeries::LightingMode::Shaded

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

QAbstract3DSeries::LightingModeも参照してください 。

mesh : Abstract3DSeries.Mesh

シリーズ内のアイテムのメッシュ、またはSurface3DSeries の場合は選択ポインタ。メッシュがAbstract3DSeries.Mesh.UserDefined の場合、アイテムが正しくレンダリングされるためにはuserDefinedMesh プロパティも設定する必要があります。デフォルト値はグラフの種類によって異なります。

QAbstract3DSeries::Meshも参照してください 。

meshAngle : real

シリーズの回転角度を度単位で定義するための便宜プロパティ。

注意： このプロパティを読み取る場合、浮動小数点精度を用いてAbstract3DSeries.meshRotation の値から計算され、常に 0 度から 360 度までの値を返します。

Abstract3DSeries.meshRotationも参照のこと 。

meshRotation : quaternion

シリーズのすべての項目に適用されるメッシュ回転。回転は正規化された四元数でなければならない。項目ごとの回転をサポートするシリーズタイプでは、回転は掛け合わされます。Bar3DSeries は、y軸周り以外の回転を無視します。Surface3DSeries は、選択ポインタにのみ回転を適用します。デフォルトは回転なし。

meshSmooth : bool

true の場合、mesh プロパティで設定された定義済みメッシュのスムースバージョンが使用されます。このプロパティは、メッシュがAbstract3DSeries.Mesh.UserDefined に設定されているときに使用されるカスタムメッシュには影響しません。デフォルトはfalse です。

multiHighlightColor : color

シリーズの複数アイテムのハイライトカラー。

colorStyle およびGraphsTheme.multiHighlightColorも参照してください 。

multiHighlightGradient : Gradient

シリーズの複数アイテムのハイライトグラデーション。

colorStyle およびGraphsTheme.multiHighlightGradientも参照のこと 。

name : string

シリーズ名。タグ@seriesName とともにアイテムラベル形式で使用できる。

itemLabelFormatも参照のこと 。

rowColors : list<Color>

このプロパティを使用して、シリーズの行を異なる色で描画することができる。このプロパティを使用するには、GraphsTheme.colorStyle をUniform に設定する必要があります。

注意： このプロパティが設定されていて、テーマが変更された場合、rowColorsリストは自動的にクリアされない。

QGraphsTheme::ColorStyle::Uniformも参照のこと 。

rowLabels : list

オプションの行ラベル。この配列のインデックスは、データ配列の行インデックスと一致します。リストが行数より短い場合は、すべての行にラベルが付与されるわけではありません。

selectedBar : point

選択されている系列内のバー。

選択されたバーの位置は、系列のデータ配列の行と列として指定される。

一度に選択できるバーは1本のみである。

この系列から選択を解除するには、invalidSelectionPosition を位置として指定する。

この系列がグラフに追加された場合、グラフはユーザーの操作に応じて、または無効となった場合に選択を調整することができる。追加された別の系列のバーを選択すると、選択範囲もクリアされる。

選択されたバーの行の前に系列から行を削除したり、系列に行を挿入したりすると、同じバーが選択されたままになるように選択範囲が調整されます。

GraphsItem3D.clearSelection()も参照 。

singleHighlightColor : color

シリーズの単一アイテムのハイライト色。

colorStyle およびGraphsTheme.singleHighlightColorも参照のこと 。

singleHighlightGradient : Gradient

シリーズの単一アイテムのハイライトグラデーション。

colorStyle およびGraphsTheme.singleHighlightGradientも参照のこと 。

type : Abstract3DSeries.SeriesType [read-only]

シリーズのタイプ。QAbstract3DSeries::SeriesType 。

userDefinedMesh : string

mesh のときに使用されるオブジェクト用のユーザー定義カスタムメッシュのファイル名はAbstract3DSeries.Mesh.UserDefined です。

注意： ファイルはQtQuick3D メッシュ形式である必要があります。他の3Dモデルフォーマットからメッシュを作成するには、balsam 変換ツールを使用してください。

visible : bool

シリーズの可視性。false の場合、シリーズはレンダリングされない。

シグナルのドキュメント

baseColorChanged(color color)

このシグナルは、baseColor がcolor に変更されたときに発せられる。

注： 対応するハンドラはonBaseColorChanged 。

baseGradientChanged(Gradient gradient)

このシグナルは、baseGradient がgradient に変更されたときに発せられる。

注： 対応するハンドラはonBaseGradientChanged 。

colorStyleChanged(GraphsTheme.ColorStyle style)

このシグナルは、colorStyle がstyle に変更されたときに発せられる。

注： 対応するハンドラはonColorStyleChanged 。

columnLabelsChanged()

このシグナルはカラムラベルが変更されたときに発せられる。

注意: 対応するハンドラはonColumnLabelsChanged です。

dataArrayChanged(BarDataArray array)

このシグナルは、dataArray がarray に変更されたときに発せられる。

注： 対応するハンドラはonDataArrayChanged 。

dataProxyChanged(BarDataProxy proxy)

このシグナルは、dataProxy がproxy に変更されたときに発せられる。

注： 対応するハンドラはonDataProxyChanged 。

itemLabelChanged(string label)

このシグナルは、itemLabel がlabel に変更されたときに発せられる。

注： 対応するハンドラはonItemLabelChanged 。

itemLabelFormatChanged(string format)

このシグナルは、itemLabelFormat がformat に変更されたときに発せられる。

注： 対応するハンドラはonItemLabelFormatChanged 。

itemLabelVisibilityChanged(bool visible)

このシグナルは、itemLabelVisibility がvisible に変更されたときに発行される。

注： 対応するハンドラはonItemLabelVisibilityChanged です。

[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

このシグナルは、lightingMode がlightingMode に変更されたときに発せられる。

注意: 対応するハンドラはonLightingModeChanged です。

このシグナルは Qt 6.10 で導入されました。

meshAngleChanged(real angle)

このシグナルは、meshAngle がangle に変更されたときに発せられる。

注： 対応するハンドラはonMeshAngleChanged 。

meshChanged(Abstract3DSeries.Mesh mesh)

このシグナルは、mesh がmesh に変更されたときに発せられる。

注： 対応するハンドラはonMeshChanged 。

meshRotationChanged(quaternion rotation)

このシグナルは、meshRotation がrotation に変更されたときに発せられる。

注： 対応するハンドラはonMeshRotationChanged 。

meshSmoothChanged(bool enabled)

このシグナルは、meshSmooth がenabled に変更されたときに発せられる。

注： 対応するハンドラはonMeshSmoothChanged 。

multiHighlightColorChanged(color color)

このシグナルは、multiHighlightColor がcolor に変更されたときに発せられる。

注： 対応するハンドラはonMultiHighlightColorChanged 。

multiHighlightGradientChanged(Gradient gradient)

このシグナルは、multiHighlightGradient がgradient に変更されたときに発せられる。

注： 対応するハンドラはonMultiHighlightGradientChanged 。

nameChanged(string name)

このシグナルは、name がname に変更されたときに発せられる。

注： 対応するハンドラはonNameChanged 。

rowColorsChanged(list<color> rowcolors)

このシグナルは、rowColors がrowcolors に変更されたときに発せられる。

注： 対応するハンドラはonRowColorsChanged 。

rowLabelsChanged()

このシグナルは、行ラベルが変更されたときに発せられる。

注: 対応するハンドラはonRowLabelsChanged です。

selectedBarChanged(point position)

このシグナルは、selectedBar がposition に変更されたときに発せられる。

注： 対応するハンドラはonSelectedBarChanged 。

singleHighlightColorChanged(color color)

このシグナルは、singleHighlightColor がcolor に変更されたときに発せられる。

注： 対応するハンドラはonSingleHighlightColorChanged 。

singleHighlightGradientChanged(Gradient gradient)

このシグナルは、singleHighlightGradient がgradient に変更されたときに発せられる。

注： 対応するハンドラはonSingleHighlightGradientChanged 。

userDefinedMeshChanged(string fileName)

このシグナルは、userDefinedMesh がfileName に変更されたときに発せられる。

注： 対応するハンドラはonUserDefinedMeshChanged 。

visibilityChanged(bool visible)

このシグナルは、シリーズの可視性がvisible に変更されたときに発行される。

注： 対応するハンドラはonVisibilityChanged 。

メソッド・ドキュメント

void setMeshAxisAndAngle(vector3d axis, real angle)

axis とangle からメッシュ回転四元数を作成する便利な関数。

meshRotationも参照してください ．

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.