Bar3DSeries QML Type
データ系列を3D棒グラフで表現します。詳細...
Import Statement: | import QtGraphs |
In C++: | QBar3DSeries |
Inherits: |
- 継承されたメンバを含む、全メンバの一覧
- Bar3DSeries はQt Graphs QML Types for 3D に含まれます。
プロパティ
- baseColor : color
- baseGradient : Gradient
- colorStyle : GraphsTheme.ColorStyle
- columnLabels : list
- dataArray : BarDataArray
- dataProxy : BarDataProxy
- invalidSelectionPosition : point
- itemLabel : string
- itemLabelFormat : string
- itemLabelVisible : bool
- mesh : Abstract3DSeries.Mesh
- meshAngle : real
- meshRotation : quaternion
- meshSmooth : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- name : string
- rowColors : list<Color>
- rowLabels : list
- selectedBar : point
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool
信号
- baseColorChanged(color color)
- baseGradientChanged(Gradient gradient)
- colorStyleChanged(GraphsTheme.ColorStyle style)
- columnLabelsChanged()
- dataArrayChanged(BarDataArray array)
- dataProxyChanged(BarDataProxy proxy)
- itemLabelChanged(string label)
- itemLabelFormatChanged(string format)
- itemLabelVisibilityChanged(bool visible)
- meshAngleChanged(real angle)
- meshChanged(Abstract3DSeries.Mesh mesh)
- meshRotationChanged(quaternion rotation)
- meshSmoothChanged(bool enabled)
- multiHighlightColorChanged(color color)
- multiHighlightGradientChanged(Gradient gradient)
- nameChanged(string name)
- rowColorsChanged(list<color> rowcolors)
- rowLabelsChanged()
- selectedBarChanged(point position)
- singleHighlightColorChanged(color color)
- singleHighlightGradientChanged(Gradient gradient)
- userDefinedMeshChanged(string fileName)
- visibilityChanged(bool visible)
方法
- void setMeshAxisAndAngle(vector3d axis, real angle)
詳細説明
この型は、シリーズ固有のビジュアルエレメントと、(データプロキシを介した)シリーズデータを管理する。
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 |
定数プロパティは、無効な選択位置を提供する。この位置は、selectedBar プロパティに代入され、この系列からの選択をクリアする。
GraphsItem3D.clearSelection()も参照 。
itemLabel : string |
フォーマットされた項目ラベル。選択された項目がない場合、または選択された項目が表示されていない場合は、空の文字列を返します。
itemLabelFormat も参照して ください。
itemLabelFormat : string |
このシリーズのデータ項目のラベルフォーマット。この書式は、項目が選択されている場合など、単一の項目ラベルに使用されます。この書式がどのように解釈されるかは、系列タイプによって異なります。
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.colorStyle をUniform
に設定する必要がある。
注意: このプロパティが設定されていて、テーマが変更された場合、rowColorsリストは自動的にクリアされない。
rowLabels : list |
配列の行ラベル。この配列のインデックスは、データ配列の行インデックスと一致する。リストが行数よりも短い場合は、すべての行にラベルが付与されません。
selectedBar : point |
選択される系列内のバー。
選択するバーの位置は、系列のデータ配列の行と列で指定する。
一度に選択できるバーは1本のみである。
この系列から選択を解除するには、invalidSelectionPosition を位置として指定する。
この系列がグラフに追加された場合、グラフはユーザーの操作に応じて、または無効となった場合に選択を調整することができる。追加された別の系列のバーを選択すると、選択範囲もクリアされる。
選択されたバーの行の前に系列から行を削除したり、系列に行を挿入したりすると、同じバーが選択されたままになるように選択範囲が調整されます。
GraphsItem3D.clearSelection()も参照 。
singleHighlightColor : color |
シリーズの単一アイテムのハイライト・カラーを設定します。
singleHighlightGradient : Gradient |
シリーズの単一アイテムのハイライト・グラデーションを設定します。
type : Abstract3DSeries.SeriesType |
シリーズのタイプ。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
です。
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
です。
このシグナルは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
です。
メソッドドキュメント
axis とangle からメッシュ回転クォータニオンを構築する便利な関数.
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.