QAbstract3DSeries Class

QAbstract3DSeries クラスは、すべての 3D データシリーズの基本クラスです。詳細...

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

QBar3DSeries QScatter3DSeries QSurface3DSeries

パブリックタイプ

enum class Mesh { UserDefined, Bar, Cube, Pyramid, Cone, …, Point }
enum class SeriesType { None, Bar, Scatter, Surface }

プロパティ

パブリック機能

virtual ~QAbstract3DSeries() override
QColor baseColor() const
QLinearGradient baseGradient() const
QGraphsTheme::ColorStyle colorStyle() const
bool isItemLabelVisible() const
bool isMeshSmooth() const
bool isVisible() const
QString itemLabel()
QString itemLabelFormat() const
QAbstract3DSeries::Mesh mesh() const
QQuaternion meshRotation() const
QColor multiHighlightColor() const
QLinearGradient multiHighlightGradient() const
QString name() const
void setBaseColor(QColor color)
void setBaseGradient(const QLinearGradient &gradient)
void setColorStyle(QGraphsTheme::ColorStyle style)
void setItemLabelFormat(const QString &format)
void setItemLabelVisible(bool visible)
void setMesh(QAbstract3DSeries::Mesh mesh)
void setMeshAxisAndAngle(QVector3D axis, float angle)
void setMeshRotation(const QQuaternion &rotation)
void setMeshSmooth(bool enable)
void setMultiHighlightColor(QColor color)
void setMultiHighlightGradient(const QLinearGradient &gradient)
void setName(const QString &name)
void setSingleHighlightColor(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(QColor color)
void baseGradientChanged(const QLinearGradient &gradient)
void colorStyleChanged(QGraphsTheme::ColorStyle style)
void itemLabelChanged(const QString &label)
void itemLabelFormatChanged(const QString &format)
void itemLabelVisibleChanged(bool visible)
void meshChanged(QAbstract3DSeries::Mesh mesh)
void meshRotationChanged(const QQuaternion &rotation)
void meshSmoothChanged(bool enabled)
void multiHighlightColorChanged(QColor color)
void multiHighlightGradientChanged(const QLinearGradient &gradient)
void nameChanged(const QString &name)
void singleHighlightColorChanged(QColor color)
void singleHighlightGradientChanged(const QLinearGradient &gradient)
void userDefinedMeshChanged(const QString &fileName)
void visibleChanged(bool visible)

詳細説明

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

詳細については、Qt Graphs 3Dによるデータ処理を参照してください。

メンバ型ドキュメント

enum class QAbstract3DSeries::Mesh

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

定数説明
QAbstract3DSeries::Mesh::UserDefined0ユーザー定義メッシュ。QAbstract3DSeries::userDefinedMesh プロパティで設定。
QAbstract3DSeries::Mesh::Bar1基本的な長方形のバー。
QAbstract3DSeries::Mesh::Cube2基本立方体。
QAbstract3DSeries::Mesh::Pyramid3四角錐。
QAbstract3DSeries::Mesh::Cone4基本円錐。
QAbstract3DSeries::Mesh::Cylinder5基本円柱。
QAbstract3DSeries::Mesh::BevelBar6わずかに面取りされた(丸みを帯びた)長方形の棒。
QAbstract3DSeries::Mesh::BevelCube7わずかに面取りされた(丸みを帯びた)立方体。
QAbstract3DSeries::Mesh::Sphere8球体。
QAbstract3DSeries::Mesh::Minimal9最小の3Dメッシュ:三角錐。Q3DScatterWidgetItem でのみ使用可能。
QAbstract3DSeries::Mesh::Arrow10上向きの矢印。
QAbstract3DSeries::Mesh::Point112D点。Q3DScatterWidgetItem でのみ使用可能。影はこのスタイルに影響しません。カラースタイルQGraphsTheme::ColorStyle::ObjectGradient はこのスタイルではサポートされていません。

enum class QAbstract3DSeries::SeriesType

シリーズのタイプ。

定数説明
QAbstract3DSeries::SeriesType::None0シリーズタイプなし。
QAbstract3DSeries::SeriesType::Bar1Q3DBarsWidgetItem
QAbstract3DSeries::SeriesType::Scatter2Q3DScatterWidgetItem のシリーズタイプ。
QAbstract3DSeries::SeriesType::Surface3Q3DSurfaceWidgetItem のシリーズタイプ。

プロパティ文書

baseColor : QColor

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

アクセス関数

QColor baseColor() const
void setBaseColor(QColor color)

通知シグナル:

void baseColorChanged(QColor color)

colorStyle およびQGraphsTheme::seriesColorsも参照のこと

baseGradient : QLinearGradient

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

アクセス関数

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

通知シグナル:

void baseGradientChanged(const QLinearGradient &gradient)

colorStyle およびQGraphsTheme::seriesGradientsも参照のこと

colorStyle : QGraphsTheme::ColorStyle

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

アクセス関数

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

通知シグナル:

void colorStyleChanged(QGraphsTheme::ColorStyle style)

QGraphsTheme::ColorStyleも参照

[read-only] itemLabel : const QString

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

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

アクセス関数

QString itemLabel()

Notifier シグナル:

void itemLabelChanged(const QString &label)

itemLabelFormatも参照

itemLabelFormat : QString

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

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

アクセス関数

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

通知シグナル:

void itemLabelFormatChanged(const QString &format)

QBar3DSeriesQScatter3DSeriesQSurface3DSeriesも参照のこと

itemLabelVisible : bool

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

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

アクセス関数:

bool isItemLabelVisible() const
void setItemLabelVisible(bool visible)

Notifier シグナル:

void itemLabelVisibleChanged(bool visible)

itemLabelFormat およびitemLabelも参照

mesh : QAbstract3DSeries::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(QColor color)

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

void multiHighlightColorChanged(QColor color)

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

multiHighlightGradient : QLinearGradient

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

アクセス関数

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

通知シグナル:

void multiHighlightGradientChanged(const QLinearGradient &gradient)

colorStyle およびQGraphsTheme::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(QColor color)

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

void singleHighlightColorChanged(QColor color)

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

singleHighlightGradient : QLinearGradient

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

アクセス関数

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

通知シグナル:

void singleHighlightGradientChanged(const QLinearGradient &gradient)

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

[read-only] type : const QAbstract3DSeries::SeriesType

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

アクセス関数:

QAbstract3DSeries::SeriesType type() const

userDefinedMesh : QString

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

カスタムメッシュは、mesh が MeshUserDefined の場合に使用されます。

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

アクセス関数

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 visibleChanged(bool visible)

メンバ関数ドキュメント

[override virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()

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

[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(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.