このページでは

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 LightingMode { Shaded, Unshaded }
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::LightingMode lightingMode() 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 setLightingMode(QAbstract3DSeries::LightingMode lightingMode)
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 lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode)
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::LightingMode

あらかじめ設定された照明モード

一定値説明
QAbstract3DSeries::LightingMode::Shaded0グラフはリアルタイムの照明変化に反応します
QAbstract3DSeries::LightingMode::Unshaded-1グラフはリアルタイムの照明に反応しません

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 : QString

このプロパティには、書式設定された項目のラベルが格納されます。

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

アクセス関数:

QString itemLabel()

通知シグナル:

void itemLabelChanged(const QString &label)

関連項目: itemLabelFormat 。

itemLabelFormat : QString

このプロパティには、この系列のデータ項目のラベル形式が格納されます。

この書式は、たとえば項目が選択された際など、単一の項目ラベルに使用されます。書式の解釈方法は、系列の種類によって異なります。

アクセス関数:

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

通知信号:

void itemLabelFormatChanged(const QString &format)

関連項目: QBar3DSeries 、QScatter3DSeries 、およびQSurface3DSeries 。

itemLabelVisible : bool

このプロパティは、グラフ内の項目ラベルの表示設定を指定します。

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

アクセス関数:

bool isItemLabelVisible() const
void setItemLabelVisible(bool visible)

通知シグナル:

void itemLabelVisibleChanged(bool visible)

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

[since 6.10] lightingMode : QAbstract3DSeries::LightingMode

このプロパティは、シリーズの照明モードを保持します

この列挙型は Qt 6.10 で導入されました。

アクセス関数:

QAbstract3DSeries::LightingMode lightingMode() const
void setLightingMode(QAbstract3DSeries::LightingMode lightingMode)

通知シグナル:

void lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode)

関連項目: LightingMode 。

mesh : QAbstract3DSeries::Mesh

このプロパティには、シリーズに含まれる項目のメッシュが格納されます。

QSurface3DSeries の場合、このプロパティには選択ポインタが格納されます。

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

アクセス関数:

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

Notifierシグナル:

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)

Notifierシグナル:

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()

「abstract 3D」シリーズを削除します。

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

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

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

meshRotationも参照してください 。

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