Bar3DSeries QML Type (Uncreatable)

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

注：これは作成不可能な型です。QML内ではインスタンス化できません。

• 継承されたメンバーを含むすべてのメンバーの一覧
• Bar3DSeriesは、Qt Graphs の3D用QML型の一部です。

プロパティ

• baseColor : color
• baseGradient : Gradient
• colorStyle : GraphsTheme.ColorStyle
• columnLabels : list
• dataArray : BarDataArray
• dataProxy : BarDataProxy
• invalidSelectionPosition : point
• itemLabel : string
• itemLabelFormat : string
• itemLabelVisible : bool
• lightingMode : Abstract3DSeries.LightingMode (since 6.10)
• 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)
• lightingModeChanged(Abstract3DSeries.LightingMode lightingMode) (since 6.10)
• 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に対して以下のフォーマットタグをサポートしています：

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

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

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

baseColor : color

このシリーズのベースカラーです。

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

baseGradient : Gradient

この数列の基本勾配。

colorStyleも参照してください 。

colorStyle : GraphsTheme.ColorStyle

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

GraphsTheme.ColorStyleも参照してください 。

columnLabels : list

配列のオプションの列ラベルです。この配列のインデックスは、行の列インデックスに対応しています。リストの長さが最長の行よりも短い場合、すべての列にラベルが付くわけではありません。

dataArray : BarDataArray

データ配列への参照を保持します。

dataArrayChanged データ配列が設定されると、newDataArray が前回のものと同一でない限り、シグナルが発信されます。

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」も参照してください 。

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

「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 です。

visible : bool

シリーズの表示設定。false の場合、シリーズは表示されません。

Signal ドキュメント

baseColorChanged(color color)

このシグナルは、baseColor がcolor に変更されたときに発生します。

baseGradientChanged(Gradient gradient)

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

colorStyleChanged(GraphsTheme.ColorStyle style)

このシグナルは、colorStyle がstyle に変更されたときに発生します。

columnLabelsChanged()

このシグナルは、列ラベルが変更されたときに発生します。

dataArrayChanged(BarDataArray array)

このシグナルは、dataArray がarray に変更されたときに発信されます。

dataProxyChanged(BarDataProxy proxy)

このシグナルは、dataProxy がproxy に変化したときに発生します。

itemLabelChanged(string label)

このシグナルは、itemLabel がlabel に変わったときに発生します。

itemLabelFormatChanged(string format)

このシグナルは、itemLabelFormat がformat に変更されたときに発生します。

itemLabelVisibilityChanged(bool visible)

このシグナルは、itemLabelVisibility が `visible` に変更されたときに発火します。

[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

このシグナルは、lightingMode がlightingMode に変更されたときに発生します。

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

meshAngleChanged(real angle)

このシグナルは、meshAngle がangle に変更されたときに発信されます。

meshChanged(Abstract3DSeries.Mesh mesh)

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

meshRotationChanged(quaternion rotation)

このシグナルは、meshRotation がrotation に切り替わったときに発信されます。

meshSmoothChanged(bool enabled)

このシグナルは、meshSmooth がenabled に変わったときに発生します。

multiHighlightColorChanged(color color)

このシグナルは、multiHighlightColor がcolor に変更されたときに発生します。

multiHighlightGradientChanged(Gradient gradient)

このシグナルは、multiHighlightGradient がgradient に変更されたときに発生します。

nameChanged(string name)

このシグナルは、name がname に変更されたときに発生します。

rowColorsChanged(list<color> rowcolors)

このシグナルは、rowColors がrowcolors に変わったときに発生します。

rowLabelsChanged()

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

selectedBarChanged(point position)

このシグナルは、selectedBar がposition に変更されたときに発生します。

singleHighlightColorChanged(color color)

このシグナルは、singleHighlightColor がcolor に変更されたときに発生します。

singleHighlightGradientChanged(Gradient gradient)

このシグナルは、singleHighlightGradient がgradient に変更されたときに発生します。

userDefinedMeshChanged(string fileName)

このシグナルは、userDefinedMesh がfileName に変更されたときに発生します。

visibilityChanged(bool visible)

このシグナルは、シリーズの見え方が「visible 」に変わったときに発せられます。

メソッドのドキュメント

void setMeshAxisAndAngle(vector3d axis, real angle)

axis およびangle からメッシュ回転クォータニオンを生成するための便利な関数です。

meshRotationも参照してください 。