QAbstract3DSeries Class

QAbstract3DSeries クラスは、すべてのデータ系列の基本クラスです。詳細...

ヘッダー #include <QAbstract3DSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
以来:QtDataVisualization 1.0
QML で: Abstract3DSeries
を継承: QObject
によって継承されています:

QBar3DSeries QScatter3DSeries QSurface3DSeries

パブリックな型

enum Mesh { MeshUserDefined, MeshBar, MeshCube, MeshPyramid, MeshCone, …, MeshPoint }
enum SeriesType { SeriesTypeNone, SeriesTypeBar, SeriesTypeScatter, SeriesTypeSurface }

プロパティ

パブリック機能

virtual ~QAbstract3DSeries()
QColor baseColor() const
QLinearGradient baseGradient() const
Q3DTheme::ColorStyle colorStyle() const
bool isItemLabelVisible() const
bool isMeshSmooth() const
bool isVisible() const
QString itemLabel() const
QString itemLabelFormat() const
QAbstract3DSeries::Mesh mesh() const
QQuaternion meshRotation() const
QColor multiHighlightColor() const
QLinearGradient multiHighlightGradient() const
QString name() const
void setBaseColor(const QColor &color)
void setBaseGradient(const QLinearGradient &gradient)
void setColorStyle(Q3DTheme::ColorStyle style)
void setItemLabelFormat(const QString &format)
void setItemLabelVisible(bool visible)
void setMesh(QAbstract3DSeries::Mesh mesh)
void setMeshAxisAndAngle(const QVector3D &axis, float angle)
void setMeshRotation(const QQuaternion &rotation)
void setMeshSmooth(bool enable)
void setMultiHighlightColor(const QColor &color)
void setMultiHighlightGradient(const QLinearGradient &gradient)
void setName(const QString &name)
void setSingleHighlightColor(const QColor &color)
void setSingleHighlightGradient(const QLinearGradient &gradient)
void setUserDefinedMesh(const QString &fileName)
void setVisible(bool visible)
QColor singleHighlightColor() const
QLinearGradient singleHighlightGradient() const
QAbstract3DSeries::SeriesType type() const
QString userDefinedMesh() const

シグナル

void baseColorChanged(const QColor &color)
void baseGradientChanged(const QLinearGradient &gradient)
void colorStyleChanged(Q3DTheme::ColorStyle style)
void itemLabelChanged(const QString &label)
void itemLabelFormatChanged(const QString &format)
void itemLabelVisibilityChanged(bool visible)
void meshChanged(QAbstract3DSeries::Mesh mesh)
void meshRotationChanged(const QQuaternion &rotation)
void meshSmoothChanged(bool enabled)
void multiHighlightColorChanged(const QColor &color)
void multiHighlightGradientChanged(const QLinearGradient &gradient)
void nameChanged(const QString &name)
void singleHighlightColorChanged(const QColor &color)
void singleHighlightGradientChanged(const QLinearGradient &gradient)
void userDefinedMeshChanged(const QString &fileName)
void visibilityChanged(bool visible)

詳細説明

サポートされるシリーズタイプごとに継承されたクラスがあります:QBar3DSeries QScatter3DSeries およびQSurface3DSeries

詳細については、Qt Data Visualization データ処理を参照してください。

メンバー・タイプ・ドキュメント

enum QAbstract3DSeries::Mesh

定義済みのメッシュタイプ。すべてのスタイルがすべての可視化タイプで使用できるわけではありません。

定数説明
QAbstract3DSeries::MeshUserDefined0ユーザー定義メッシュ。QAbstract3DSeries::userDefinedMesh プロパティで設定。
QAbstract3DSeries::MeshBar1基本的な長方形のバー。
QAbstract3DSeries::MeshCube2基本立方体。
QAbstract3DSeries::MeshPyramid3四角錐。
QAbstract3DSeries::MeshCone4基本円錐。
QAbstract3DSeries::MeshCylinder5基本円柱。
QAbstract3DSeries::MeshBevelBar6わずかに面取りされた(丸みを帯びた)長方形の棒。
QAbstract3DSeries::MeshBevelCube7わずかに面取りされた(丸みを帯びた)立方体。
QAbstract3DSeries::MeshSphere8球体。
QAbstract3DSeries::MeshMinimal9最小の3Dメッシュ:三角錐。Q3DScatter でのみ使用可能。
QAbstract3DSeries::MeshArrow10上向きの矢印。
QAbstract3DSeries::MeshPoint112D点。Q3DScatter でのみ使用可能。影はこのスタイルに影響しません。カラースタイルQ3DTheme::ColorStyleObjectGradient はこのスタイルではサポートされていません。

enum QAbstract3DSeries::SeriesType

シリーズのタイプ。

定数説明
QAbstract3DSeries::SeriesTypeNone0シリーズタイプなし。
QAbstract3DSeries::SeriesTypeBar1Q3DBars
QAbstract3DSeries::SeriesTypeScatter2Q3DScatter のシリーズタイプ。
QAbstract3DSeries::SeriesTypeSurface4Q3DSurface のシリーズタイプ。

プロパティ文書

baseColor : QColor

このプロパティは、シリーズのベースカラーを保持する。

アクセス関数

QColor baseColor() const
void setBaseColor(const QColor &color)

通知シグナル:

void baseColorChanged(const QColor &color)

colorStyle およびQ3DTheme::baseColorsも参照のこと

baseGradient : QLinearGradient

このプロパティは、系列の基本勾配を保持する。

アクセス関数

QLinearGradient baseGradient() const
void setBaseGradient(const QLinearGradient &gradient)

通知シグナル:

void baseGradientChanged(const QLinearGradient &gradient)

colorStyle およびQ3DTheme::baseGradientsも参照のこと

colorStyle : Q3DTheme::ColorStyle

このプロパティは、シリーズのカラースタイルを保持する。

アクセス関数

Q3DTheme::ColorStyle colorStyle() const
void setColorStyle(Q3DTheme::ColorStyle style)

通知シグナル:

void colorStyleChanged(Q3DTheme::ColorStyle style)

Q3DTheme::ColorStyleも参照

[read-only, since QtDataVisualization 1.1] itemLabel : const QString

このプロパティは、フォーマットされた項目ラベルを保持する。

選択された項目がない場合、または選択された項目が表示されていない場合は、空の文字列を返します。

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

アクセス関数です:

QString itemLabel() const

Notifier シグナル:

void itemLabelChanged(const QString &label)

itemLabelFormatも参照してください

itemLabelFormat : QString

このプロパティは、このシリーズのデータ項目のラベルフォーマットを保持する。

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

アクセス関数:

QString itemLabelFormat() const
void setItemLabelFormat(const QString &format)

通知シグナル:

void itemLabelFormatChanged(const QString &format)

[since QtDataVisualization 1.1] itemLabelVisible : bool

このプロパティは、グラフ内の項目ラベルの可視性を保持する。

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

このプロパティは、QtDataVisualization 1.1 で導入されました。

アクセス関数:

bool isItemLabelVisible() const
void setItemLabelVisible(bool visible)

Notifier シグナル:

void itemLabelVisibilityChanged(bool visible)

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

mesh : Mesh

このプロパティは、シリーズ内のアイテムのメッシュを保持する。

QSurface3DSeries の場合、このプロパティは選択ポインタを保持する。

メッシュがMeshUserDefined の場合、アイテムを正しくレンダリングするにはuserDefinedMesh プロパティも設定する必要があります。デフォルト値はグラフタイプによって異なります。

アクセス関数:

QAbstract3DSeries::Mesh mesh() const
void setMesh(QAbstract3DSeries::Mesh mesh)

通知シグナル:

void meshChanged(QAbstract3DSeries::Mesh mesh)

meshRotation : QQuaternion

このプロパティは、シリーズの全アイテムに適用されるメッシュ回転を保持する。

回転は正規化されたQQuaternion でなければならない。アイテム固有の回転をサポートするシリーズタイプでは、回転は乗算されます。QBar3DSeries は、Y軸の周りではない回転を無視します。QSurface3DSeries は、選択ポインタにのみ回転を適用します。デフォルトは回転なし。

アクセス関数:

QQuaternion meshRotation() const
void setMeshRotation(const QQuaternion &rotation)

通知シグナル:

void meshRotationChanged(const QQuaternion &rotation)

meshSmooth : bool

このプロパティは、定義済みメッシュのスムースバージョンを使用するかどうかを保持します。

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

アクセス関数:

bool isMeshSmooth() const
void setMeshSmooth(bool enable)

通知シグナル:

void meshSmoothChanged(bool enabled)

multiHighlightColor : QColor

このプロパティは、シリーズの複数項目のハイライト色を保持する。

アクセス関数

QColor multiHighlightColor() const
void setMultiHighlightColor(const QColor &color)

ノーティファイアシグナル:

void multiHighlightColorChanged(const QColor &color)

colorStyle およびQ3DTheme::multiHighlightColorも参照のこと

multiHighlightGradient : QLinearGradient

このプロパティは、シリーズの複数項目のハイライトグラデーションを保持する。

アクセス関数

QLinearGradient multiHighlightGradient() const
void setMultiHighlightGradient(const QLinearGradient &gradient)

通知シグナル:

void multiHighlightGradientChanged(const QLinearGradient &gradient)

colorStyle およびQ3DTheme::multiHighlightGradientも参照のこと

name : QString

このプロパティはシリーズ名を保持する。

このシリーズ名は、@seriesName タグを使用して、項目ラベル形式で使用することができる。

アクセス関数

QString name() const
void setName(const QString &name)

ノーティファイアシグナル:

void nameChanged(const QString &name)

itemLabelFormatも参照

singleHighlightColor : QColor

このプロパティは、シリーズの単一項目のハイライト色を保持する。

アクセス関数

QColor singleHighlightColor() const
void setSingleHighlightColor(const QColor &color)

ノーティファイアシグナル:

void singleHighlightColorChanged(const QColor &color)

colorStyle およびQ3DTheme::singleHighlightColorも参照のこと

singleHighlightGradient : QLinearGradient

このプロパティは、シリーズの単一アイテムのハイライトグラデーションを保持する。

アクセス関数

QLinearGradient singleHighlightGradient() const
void setSingleHighlightGradient(const QLinearGradient &gradient)

通知シグナル:

void singleHighlightGradientChanged(const QLinearGradient &gradient)

colorStyle およびQ3DTheme::singleHighlightGradientも参照のこと

[read-only] type : const SeriesType

このプロパティは、系列の型を保持する。

アクセス関数:

QAbstract3DSeries::SeriesType type() const

userDefinedMesh : QString

このプロパティは、オブジェクト用のユーザー定義カスタムメッシュのファイル名を保持します。

カスタムメッシュは、meshMeshUserDefined のときに使用されます。

注意: ファイルは Wavefront OBJ フォーマットで、頂点、法線、UV を含む必要があります。また、三角形である必要があります。

アクセス関数

QString userDefinedMesh() const
void setUserDefinedMesh(const QString &fileName)

通知シグナル:

void userDefinedMeshChanged(const QString &fileName)

visible : bool

このプロパティはシリーズの可視性を保持する。

このプロパティがfalse の場合、系列はレンダリングされない。デフォルトはtrue である。

アクセス関数:

bool isVisible() const
void setVisible(bool visible)

通知シグナル:

void visibilityChanged(bool visible)

メンバ関数ドキュメント

[virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()

抽象3Dシリーズを削除する。

[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(const QVector3D &axis, float angle)

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

Note: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

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.