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 および GraphsTheme.seriesGradients も参照して ください。


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

このシリーズのデータ項目のラベルフォーマット。この書式は、項目が選択されている場合など、単一の項目ラベルに使用されます。この書式がどのように解釈されるかは、系列タイプによって異なります。

Bar3DSeriesScatter3DSeriesSurface3DSeriesも参照


itemLabelVisible : bool

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

itemLabelFormat およびitemLabelも参照してください


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.colorStyleUniform に設定する必要がある。

注意: このプロパティが設定されていて、テーマが変更された場合、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

meshAbstract3DSeries.Mesh.UserDefined の場合に使用される、ユーザー定義のオブジェクト用カスタムメッシュのファイル名を設定します。

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


visible : bool

シリーズの可視性を設定します。false の場合、系列はレンダリングされません。


シグナル ドキュメント

baseColorChanged(color color)

このシグナルは、baseColorcolor に変更されたときに発行されます。

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


baseGradientChanged(Gradient gradient)

このシグナルはbaseGradientgradient に変更されたときに発行される。

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


colorStyleChanged(GraphsTheme.ColorStyle style)

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

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


columnLabelsChanged()

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

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


dataArrayChanged(BarDataArray array)

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

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


dataProxyChanged(BarDataProxy proxy)

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

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


itemLabelChanged(string label)

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

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


itemLabelFormatChanged(string format)

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

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


itemLabelVisibilityChanged(bool visible)

itemLabelVisibility がvisible に変更されると、このシグナルが発生します。

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


meshAngleChanged(real angle)

このシグナルはmeshAngleangle に変更されたときに発行されます。

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


meshChanged(Abstract3DSeries.Mesh mesh)

このシグナルはmeshmesh に変更されたときに発行されます。

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


meshRotationChanged(quaternion rotation)

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

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


meshSmoothChanged(bool enabled)

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

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


multiHighlightColorChanged(color color)

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

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


multiHighlightGradientChanged(Gradient gradient)

このシグナルは、multiHighlightGradientgradient に変わったときに発せられる。

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


nameChanged(string name)

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

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


rowColorsChanged(list<color> rowcolors)

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

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


rowLabelsChanged()

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

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


selectedBarChanged(point position)

このシグナルは、selectedBarposition に変わったときに発せられる。

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


singleHighlightColorChanged(color color)

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

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


singleHighlightGradientChanged(Gradient gradient)

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

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


userDefinedMeshChanged(string fileName)

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

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


visibilityChanged(bool visible)

このシグナルは、シリーズの可視性がvisible に変化したときに発せられる。

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


メソッドドキュメント

void setMeshAxisAndAngle(vector3d axis, real angle)

axisangle からメッシュ回転クォータニオンを構築する便利な関数.

meshRotationも参照してください


© 2025 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.